Onigeya Siyuan MCP Server

🚀 SiYuan ノート MCP サーバー実装

このプロジェクトは、Node.js をベースにした SiYuan ノートシステムの MCP（Model Context Protocol）サーバーの実装です。このサーバーを通じて、Claude などの AI モデルを SiYuan ノートシステムとシームレスに統合することができます。

✨ 主な機能

• 環境変数で SIYUAN_TOKEN を設定することで、認証をサポートします。
• 完全なコマンドリストを提供し、SiYuan ノートシステムとの相互作用をサポートします。
• ローカルでの実行と Docker コンテナ化によるデプロイをサポートします。
• オープンソースライセンスは ISC ライセンスです。

📚 ドキュメント

🔧 環境変数の設定

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

• SIYUAN_TOKEN：SiYuan ノート API トークン（必須）
  • 取得方法：SiYuan ノートの設定 - 概要 で確認できます。
  • 用途：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 ライセンスの下で公開されています。これは、あなたが自由にソフトウェアを使用、変更、配布できることを意味しますが、ISC ライセンスの条項と条件に従う必要があります。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。

関連リソース

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