Siyuan MCP Server

🚀 思源筆記 MCP 服務器

思源筆記 MCP 服務器可與思源筆記 API 集成，遵循 MCP 協議為 AI 模型提供上下文數據，還支持通過 MCP 協議調用各類命令，如文件操作、網絡請求等。

✨ 主要特性

• 與思源筆記 API 的集成：通過 SIYUAN_TOKEN 環境變量實現身份驗證和授權。
• MCP 協議支持：遵循 Model Context Protocol (MCP)，為 AI 模型提供上下文數據。
• 命令執行：支持通過 MCP 協議調用各種命令，包括文件操作、網絡請求等。

📦 安裝指南

環境要求

• Node.js >= 23.10.0
• pnpm

本地安裝

1. 安裝依賴：

pnpm install

2. 設置環境變量：

# Windows
set SIYUAN_TOKEN=your-siyuan-token

# Linux/macOS
export SIYUAN_TOKEN=your-siyuan-token

3. 啟動服務：

pnpm start

Docker 安裝

docker run --rm -i \
  -e SIYUAN_TOKEN=your-siyuan-token \
  mcp/siyuan

💻 使用示例

基礎用法

環境變量配置

服務器需要以下環境變量：

• SIYUAN_TOKEN：思源筆記 API 令牌（必需）

在 Claude Desktop 中使用

將以下配置添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "siyuan": {
      "command": "npx",
      "args": [
        "-y",
        "@onigeya/siyuan-mcp-server"
      ],
      "env": {
        "SIYUAN_TOKEN": "your-siyuan-token"
      }
    }
  }
}

📚 詳細文檔

構建

本地構建

pnpm build

Docker 構建

docker build -t mcp/siyuan .

📄 許可證

本項目基於 ISC 許可證發佈。詳細信息請參見項目倉庫中的 LICENSE 文件。

🔗 相關資源

• 思源筆記
• Model Context Protocol
• 思源筆記 API 文檔