loading…
Search for a command to run...
loading…
Provides LLMs with access to molt-md, an encrypted markdown document hosting service, for managing and reading secure knowledge bases. It enables users to creat
Provides LLMs with access to molt-md, an encrypted markdown document hosting service, for managing and reading secure knowledge bases. It enables users to create, update, and organize encrypted documents into workspaces with full version control and end-to-end encryption.
A Model Context Protocol (MCP) server that provides LLM access to molt-md, an encrypted markdown document hosting service. Turn your markdown files into an LLM-accessible knowledge base by uploading them to molt-md and accessing them through this MCP server. Your AI assistant can read, update, and manage encrypted markdown documents organized in workspaces.
Install directly from GitHub using uvx:
uvx --from git+https://github.com/bndkts/molt-md-mcp molt-mcp
Or install from source for development:
git clone https://github.com/bndkts/molt-md-mcp.git
cd molt-md-mcp
uv pip install -e .
Add to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"molt-md": {
"command": "uvx",
"args": ["--from", "git+https://github.com/bndkts/molt-md-mcp", "molt-mcp"],
"env": {
"MOLT_API_KEY": "your-api-key-here",
"MOLT_WORKSPACE_ID": "your-workspace-id-here"
}
}
}
}
MOLT_API_KEY (required) - Your molt-md write key or read key (obtained by creating a document)MOLT_WORKSPACE_ID (optional) - Access documents through a specific workspaceMOLT_BASE_URL (optional) - API base URL (defaults to https://api.molt-md.com/api/v1; use http://localhost:8000/api/v1 for local development)The server passes your configured key to the molt-md API on every request:
403 Forbidden from the APIhealth_check - Check if the molt-md API is availableget_metrics - Get database statistics (document and workspace counts)read_doc - Read a document's decrypted contentlines parameterread_workspace - Read a workspace's content (name and entries)preview_lines parametercreate_doc - Create a new encrypted documentupdate_doc - Replace a document's entire contentif_match (version ETag)append_doc - Append content to the end of a documentif_matchdelete_doc - Permanently delete a documentcreate_workspace - Create a new workspace to bundle documentsupdate_workspace - Replace a workspace's content (name and entries)if_matchdelete_workspace - Permanently delete a workspaceUser: Create a new document with the title "Meeting Notes"
Assistant: [Uses create_doc tool] → Returns doc ID and keys
User: Read that document
Assistant: [Uses read_doc tool with the doc ID]
User: Append a new section to the document
Assistant: [Uses append_doc tool]
User: Create a workspace called "Project Alpha" with these two documents
Assistant: [Uses create_workspace tool with document IDs and keys]
User: Show me a preview of all documents in the workspace
Assistant: [Uses read_workspace with preview_lines=1]
User: Show me just the title of document xyz
Assistant: [Uses read_doc with lines=1 and as_markdown=true]
# Clone the repository
git clone https://github.com/bndkts/molt-md-mcp.git
cd molt-md-mcp
# Install dependencies
uv pip install -e .
# Run the server
molt-mcp
With local molt-md API:
# Start the molt-md API server first (in another terminal)
cd /path/to/molt-md
cargo run # or your preferred method
# Create a test document to get keys
curl -X POST http://localhost:8000/api/v1/docs \
-H "Content-Type: application/json" \
-d '{"content": "# Test Document"}'
# Save the write_key and id from the response
# Run the MCP server
export MOLT_BASE_URL="http://localhost:8000/api/v1"
export MOLT_API_KEY="your-write-key-here"
npx @modelcontextprotocol/inspector molt-mcp
With production molt-md API:
# Create a test document to get keys
curl -X POST https://api.molt-md.com/api/v1/docs \
-H "Content-Type: application/json" \
-d '{"content": "# Test Document"}'
# Save the write_key from the response
# Run the MCP server
export MOLT_API_KEY="your-write-key-here"
npx @modelcontextprotocol/inspector molt-mcp
This is a thin wrapper around the molt-md REST API:
MIT License - see LICENSE file for details
Contributions are welcome! Please open an issue or pull request on GitHub.
Built with ❤️ for the Model Context Protocol ecosystem
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"molt-mcp": {
"command": "npx",
"args": []
}
}
}