Siyuan MCP Server

🚀 思源笔记 MCP サーバー

このサーバーは思源ノートと統合され、MCPプロトコルをサポートし、AIモデルにコンテキストデータを提供します。

🚀 クイックスタート

このサーバーを使用するには、まず必要な環境変数を設定する必要があります。その後、Claude Desktopでの使用や、ローカルまたはDockerでの実行が可能です。

✨ 主な機能

• 思源ノートAPIとの統合：SIYUAN_TOKEN環境変数を使用して、認証と承認を実現します。
• MCPプロトコルのサポート：Model Context Protocol (MCP)に準拠し、AIモデルにコンテキストデータを提供します。
• コマンド実行：MCPプロトコルを介して、ファイル操作やネットワークリクエストなどのさまざまなコマンドを呼び出すことができます。

📦 インストール

環境変数の設定

サーバーには以下の環境変数が必要です。

• 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"
      }
    }
  }
}

ローカルでの実行

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

📚 ドキュメント

ビルド

環境要件

• Node.js >= 23.10.0
• pnpm

ローカルビルド

pnpm build

Dockerビルド

docker build -t mcp/siyuan .

📄 ライセンス

このプロジェクトはISCライセンスの下で公開されています。詳細については、プロジェクトリポジトリ内のLICENSEファイルを参照してください。

関連リソース

• 思源ノート
• Model Context Protocol
• 思源ノートAPIドキュメント