CouchDB MCP服务器用于黑曜石(远程/铁路)
用Go编写的专业级模型上下文协议(MCP)服务器,允许LLM读取和写入存储在CouchDB实例中的黑曜石笔记。此版本支持 SSE(服务器发送事件)传输,这是远程MCP连接的官方标准。
特性
- 苏格兰和南方能源公司运输:完全符合远程客户端的MCP规范(Claude、Gemini CLI等)
- 两步协议:用途
/sse对于溪流和/message用于JSON-RPC命令。 - 安全:包括承载令牌(API密钥)身份验证。
- 搜索与发现:包括
search_notes和list_notes用于强大的笔记检索。
先决条件
- 转到1.25.7+
- CouchDB实例(例如,托管在Railway上)
配置
服务器是通过环境变量配置的:
| 变量 | 要求 | 描述 |
|---|---|---|
COUCHDB_URL | 必需 | CouchDB数据库的完整URL(例如。, http://...:5984/db_name) |
COUCHDB_USER | 可选 | 您的CouchDB用户名 |
COUCHDB_PASS | 可选 | 您的CouchDB密码 |
MCP_API_KEY | 必需 | 秘密令牌。必须在 Authorization: Bearer 头球 |
PUBLIC_URL | 必需 | 您的公共铁路URL(例如。, https://your-app.up.railway.app) |
PORT | 可选 | 要监听的端口(默认:8080) |
铁路部署
- 叉或推 将此存储库添加到您的GitHub。
- 创建一个新项目 在铁路上,连接您的代表。
- 添加变量:确保设置
COUCHDB_URL,MCP_API_KEY,以及PUBLIC_URL. - 铁路将使用
Dockerfile.
连接到Gemini CLI
要将此远程服务器添加到Gemini CLI,请使用 /sse 端点:
gemini mcp add --transport http --header "Authorization: Bearer " obsidian-remote https://your-app.up.railway.app/sse可用工具
list_notes:列出金库中的所有笔记。get_note(title):获取特定笔记的内容。update_note(title, content):更新或创建注释。search_notes(query):在所有笔记中搜索关键字。ping_couchdb:测试MCP服务器和CouchDB之间的连接。
许可证
麻省理工学院
