___ ___ _ _
| \/ | | | | |
| . . | __ _ _ __ __| |_ __ | | ___ _ __
| |\/| |/ _` | '__/ _` | '_ \| |/ _ \| '_ \
| | | | (_| | | | (_| | | | | | (_) | |_) |
\_| |_/\__,_|_| \__,_|_| |_|_|\___/| .__/
| |
__ __ ____ ____ |_|
| \/ |/ ___| _ \
| |\/| | | | |_) |
| | | | |___| __/
|_| |_|\____|_|面向代理的Markdown知识工作区
让Claude Code即时访问共享文档。自动同步标记文件，人工智能智能标记它们，并在开发过程中上下文检索它们。
______________________________________________________________________
📑 目录
______________________________________________________________________
🎯 这是什么？
此MCP服务器将Claude Desktop连接到您的Markdrop知识库。结合Claude Code挂钩（自动捕获markdown文件），您将获得一个完整的RAG驱动的开发工作流程：
- 📝 钩子：自动捕获markdown文档→ Markdrop（带AI标签）
- 🔍 主控程序：Claude在需要时检索相关文档→ 更好的上下文
- 🤖 结果：您自己的文档将成为Claude的可搜索知识
🚀 安装
MCP服务器包含在您的Markdrop安装中 markdrop-mcp-server/。依赖项已安装。
1.找到你的Markdrop路径
cd /path/to/your/markdrop
pwd # Copy this path2.获取API密钥
在Markdrop中创建API密钥： 仪表盘→ API
3.配置克劳德桌面
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"markdrop": {
"command": "node",
"args": ["/absolute/path/to/your/markdrop/markdrop-mcp-server/index.js"],
"env": {
"MARKDROP_API_URL": "http://localhost:3000",
"MARKDROP_API_KEY": "md_xxxxxxxxxxxx",
"MARKDROP_PROJECT_ID": "optional-project-id"
}
}
}
}💡 专业提示：
- 使用 绝对路径 给你的
index.js文件 - 集
MARKDROP_PROJECT_ID自动筛选特定项目的搜索 - 为多项目工作流运行多个MCP实例
4.重新启动克劳德桌面
完全退出并重新启动Claude Desktop。您将看到Markdrop工具出现！ ✨
🛠️ 可用工具
🔍 search_pastes
按内容、标题、标签或主题搜索您的知识库。
参数：
query（必填）-搜索查询以匹配内容和标题tags（可选）-要过滤的标签数组（例如。，["architecture", "api"])category（可选）-按类别筛选documentType（可选）-按类型过滤（例如。，"architecture","decision-record")limit（可选）-最大结果（默认值：10）
试着问：
“在我的粘贴中搜索API体系结构文档”
______________________________________________________________________
📄 get_paste
检索特定粘贴的完整内容和元数据。
参数：
pasteId（必填）-要检索的粘贴ID
试着问：
“获取粘贴abc123的完整内容”
______________________________________________________________________
🏷️ list_tags
列出所有可用的标签及其计数。非常适合发现记录的内容。
参数：
category（可选）-按类别过滤标签minCount（可选）-每个标签的最小粘贴量（默认值：1）
试着问：
“我的文档中有哪些标签？”
______________________________________________________________________
⏰ get_recent_pastes
获取最近创建或修改的粘贴。
参数：
limit（可选）-最大结果（默认值：10）projectId（可选）-按项目筛选documentType（可选）-按文档类型筛选
试着问：
“显示我最近的文档”
💬 如何使用
配置后，自然地问克劳德：
- 💭 *“在我的粘贴中搜索身份验证流程文档”*
- 📚 *“我有什么架构文档？”*
- 📝 *“显示我最近编写的API文档”*
- 🗄️ *“获取有关数据库迁移的粘贴”*
Claude将自动使用这些工具从您的知识库中查找相关上下文。
🔄 工作流程
┌─────────────────────────────────────────────────────────┐
│ 1. Create docs with Claude Code │
│ ↓ (Hook auto-syncs with AI tagging) │
│ 2. Stored in Markdrop │
│ ↓ (Searchable, organized, tagged) │
│ 3. Ask Claude questions │
│ ↓ (MCP retrieves relevant docs) │
│ 4. Claude responds with YOUR context │
│ ↓ (Better answers, project-specific) │
│ 5. Repeat → Build knowledge base over time │
└─────────────────────────────────────────────────────────┘这创建了一个 反馈循环 您的开发文档将成为未来工作的可搜索上下文。您的文档越多，Claude对您的项目就越聪明！
🔧 故障排除
🤔 MCP服务器未在Claude Desktop中显示？
- ✅ 检查配置文件：
~/Library/Application Support/Claude/claude_desktop_config.json - ✅ 验证到的绝对路径
index.js是正确的 - ✅ 完全退出并重新启动Claude Desktop
🚫 身份验证错误？
- ✅ 验证
MARKDROP_API_KEY正确（仪表板→ API) - ✅ 检查Markdrop是否在指定的URL上运行
- ✅ 手动测试：
curl -H "Authorization: Bearer md_xxxxxxxxxxxx" \
http://localhost:3000/api/pastes/search?query=test🔍 搜索时没有结果？
- ✅ 确保你先创建了一些粘贴
- ✅ 验证它们是否有标签（使用Claude Code钩子进行自动标记）
- ✅ 尝试更广泛的搜索查询
- ✅ 检查你的
MARKDROP_PROJECT_ID并没有把所有东西都过滤掉
🔑 需要API密钥吗？
在Markdrop中创建一个： 仪表盘→ API → 创建新密钥
______________________________________________________________________
🏗️ 建筑
┌─────────────────┐
│ Claude Desktop │
└────────┬────────┘
│ stdio (MCP Protocol)
↓
┌─────────────────┐
│ MCP Server │ (@modelcontextprotocol/sdk)
└────────┬────────┘
│ HTTP/Bearer Auth
↓
┌─────────────────┐
│ Markdrop API │ (REST API)
└─────────────────┘技术栈：
@modelcontextprotocol/sdk-标准MCP协议实施- Stdio传输-通过stdin/stdout与Claude通信
- Markdrop REST API-搜索和检索粘贴
- 承载令牌认证-安全的API身份验证
______________________________________________________________________
🧪 发展
在本地测试服务器：
# Set environment variables
export MARKDROP_API_URL="http://localhost:3000"
export MARKDROP_API_KEY="md_xxxxxxxxxxxx"
# Run server (expects JSON input via stdin)
node index.js
# Or with inspector for debugging
node --inspect index.js注： 服务器会登录到stderr，因此调试输出不会干扰MCP通信。
______________________________________________________________________
📄 许可证
麻省理工学院
______________________________________________________________________
由以下材料制成❤️ Claude Code社区