为 siyuan-note 设计的一个小型 MCP 服务器

中文

✨ 快速开始

• 从市场下载或 1. 解压 Release 中的 package.zip，2. 将文件夹移动到 workspace/data/plugins/，3. 并将文件夹重命名为 syplugin-anMCPServer；
• 启用插件；
• 插件默认监听端口 16806（主机: 127.0.0.1），请使用 http://127.0.0.1:16806/sse 作为服务器访问地址；

⭐ 如果这对您有帮助，请考虑给它一个星标！

🔧 支持的工具

• [搜索]
  • 使用关键词搜索；
  • 使用 SQL 搜索；
• [检索]
  • 通过 ID 获取文档 kramdown；
  • 列出笔记本；
• [写入]
  • 追加内容到日记；
  • 通过 ID 追加内容到特定文档；

❓ 常见问题

• Q: 如何在 MCP 客户端中使用它？

  • A: 修改 MCP 应用程序的配置以选择 SSE 类型并配置端点，例如：
    json
    {
    "mcpServers": {
    "siyuan": {
    "type": "sse",
    "command": "http://127.0.0.1:16806/sse",
    "args": [
    ""
    ],
    "env": {},
    "auto_approve": false
    }
    }
    }

• Q: 我的 MCP 客户端不支持基于 HTTP 的通信，只支持 stdio。

  • 使用支持 HTTP 通信的 MCP 主机应用程序；

  • 或者使用 node.js + mcp-remote 解决方案
    bash
    npm install -g mcp-remote

    在应用程序中使用类似以下的配置：
    json
    {
    "servers": [
    {
    "name": "Siyuan",
    "key": "siyuan",
    "description": "读取笔记",
    "command": "npx",
    "args": [
    "mcp-remote",
    "http://127.0.0.1:16806/sse"
    ],
    "isActive": true
    }
    ]
    }

• Q: 有哪些常见的 MCP 客户端？

  • 请参考：https://github.com/punkpeye/awesome-mcp-clients 或 https://modelcontextprotocol.io/clients；

🙏 参考与致谢

一些依赖项列在 package.json 中。