Obsidian远程MCP服务器

一个专业的模型上下文协议(MCP)服务器,允许LLMs读写存储在CouchDB实例中的Obsidian笔记,支持SSE传输和多种笔记操作功能。

  • by datojije
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 datojije/couchdb-mcp

使用说明

CouchDB MCP服务器用于黑曜石(远程/铁路)

用Go编写的专业级模型上下文协议(MCP)服务器,允许LLM读取和写入存储在CouchDB实例中的黑曜石笔记。此版本支持 SSE(服务器发送事件)传输,这是远程MCP连接的官方标准。

特性

  • 苏格兰和南方能源公司运输:完全符合远程客户端的MCP规范(Claude、Gemini CLI等)
  • 两步协议:用途 /sse 对于溪流和 /message 用于JSON-RPC命令。
  • 安全:包括承载令牌(API密钥)身份验证。
  • 搜索与发现:包括 search_notes 和 list_notes 用于强大的笔记检索。

先决条件

配置

服务器是通过环境变量配置的:

变量 要求 描述
COUCHDB_URL 必需 CouchDB数据库的完整URL(例如。, http://...:5984/db_name)
COUCHDB_USER 可选 您的CouchDB用户名
COUCHDB_PASS 可选 您的CouchDB密码
MCP_API_KEY 必需 秘密令牌。必须在 Authorization: Bearer <token> 头球
PUBLIC_URL 必需 您的公共铁路URL(例如。, https://your-app.up.railway.app)
PORT 可选 要监听的端口(默认:8080)

铁路部署

  1. 叉或推 将此存储库添加到您的GitHub。
  2. 创建一个新项目 在铁路上,连接您的代表。
  3. 添加变量:确保设置 COUCHDB_URL, MCP_API_KEY,以及 PUBLIC_URL.
  4. 铁路将使用 Dockerfile.

连接到Gemini CLI

要将此远程服务器添加到Gemini CLI,请使用 /sse 端点:

gemini mcp add --transport http --header "Authorization: Bearer <YOUR_API_KEY>" 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之间的连接。

许可证

麻省理工学院