Md Log MCP server
{
"mcpServers": {
"md-log": {
"command": "npx",
"args": [
"-y",
"md-log-mcp@latest"
],
"env": {
"MDLOG_API_BASE_URL": "https://...",
"MDLOG_HTTP_PATH": "/path/to/directory"
}
}
}
}{
"mcpServers": {
"md-log": {
"command": "npx",
"args": [
"-y",
"md-log-mcp@latest"
],
"env": {
"MDLOG_API_BASE_URL": "https://...",
"MDLOG_HTTP_PATH": "/path/to/directory"
}
}
}
}{
"mcpServers": {
"md-log": {
"command": "npx",
"args": [
"-y",
"md-log-mcp@latest"
],
"env": {
"MDLOG_API_BASE_URL": "https://...",
"MDLOG_HTTP_PATH": "/path/to/directory"
}
}
}
}{
"servers": {
"md-log": {
"command": "npx",
"args": [
"-y",
"md-log-mcp@latest"
],
"env": {
"MDLOG_API_BASE_URL": "${input:mdlog_api_base_url}",
"MDLOG_HTTP_PATH": "${input:mdlog_http_path}"
}
}
},
"inputs": [
{
"id": "mdlog_api_base_url",
"type": "promptString",
"description": "Mdlog api base url",
"password": true
},
{
"id": "mdlog_http_path",
"type": "promptString",
"description": "Mdlog http path",
"password": true
}
]
}{
"mcpServers": {
"md-log": {
"command": "npx",
"args": [
"-y",
"md-log-mcp@latest"
],
"env": {
"MDLOG_API_BASE_URL": "https://...",
"MDLOG_HTTP_PATH": "/path/to/directory"
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y md-log-mcpversion 1.1.4
What it does
An MCP server that lets AI agents save markdown reports with embedded images into md-log, a hosted service for versioned document storage and human review. Agents connect via stdio (local) or HTTP (remote) transport with Personal Access Token authentication.
- Save AI-generated analysis reports as immutable markdown files with embedded screenshots, organizing them by project path and date.
- Retrieve previous versions of reports for comparison or restore old analysis work from version history.
- Search and list markdown documents stored in md-log to track agent work and review findings across projects.
Tools this server exposes
| Tool | Does |
|---|---|
| save_markdown | Create or overwrite a markdown file by path; auto-creates missing folders, uploads embedded images, rewrites image references to asset links, and accepts a comm |
| upload_asset | Upload an image as base64 or from a local file path and return an asset:// reference to embed in markdown. |
| append_to_markdown | Append content to an existing markdown file with optimistic concurrency control and auto-retry on conflict. |
| update_markdown | Replace a markdown file's content with optional version checking to detect concurrent edits. |
| get_markdown | Read a markdown file's current or historical content by path and version number. |
| list_versions | List a file's immutable version history with version numbers, commit messages, authors, timestamps, and sizes. |
| delete_markdown | Soft-delete a markdown file by path with confirmation required. |
| create_folder | Create a folder path, auto-creating all missing parent folders. |
| list_folders | Return the complete folder tree structure. |
| list_files | List documents and immediate subfolders inside a folder path. |
| search_markdown | Search markdown documents by title substring and full-text body search across current versions. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.