nocobase-mcp-server

NocoBase用のMCP（Model Context Protocol）サーバーです。ClaudeのようなAIアシスタントがNocoBaseインスタンスと対話し、コレクションの読み取り、UIスキーマの管理、flowPageブロックの構築、OpenAPI経由での動的なAPI操作の実行を可能にします。

機能

• 24個の手動作成ツール: コレクション、UIスキーマ、デスクトップルート、フローモデル、JSブロックをカバー

• 動的ツール: NocoBaseのOpenAPI/Swagger仕様から自動生成（APIドキュメントプラグインが必要）

• NocoBase v2.xに対応（2.0.17-fullでテスト済み）

要件

• Node.js 18以上

• 実行中のNocoBaseインスタンス

• NocoBase APIトークン（ルート権限または十分な権限を持つもの）

インストール

1. クローンして依存関係をインストール

git clone https://github.com/your-username/nocobase-mcp-server.git
cd nocobase-mcp-server
pnpm install

2. Claude Code（または任意のMCPクライアント）の設定

~/.claude/mcp.json（Claude CodeのグローバルMCP設定）に追加します：

{
  "mcpServers": {
    "nocobase": {
      "type": "stdio",
      "command": "/absolute/path/to/nocobase-mcp-server/node_modules/.bin/tsx",
      "args": ["/absolute/path/to/nocobase-mcp-server/src/index.ts"],
      "env": {
        "NOCOBASE_URL": "http://localhost:13000",
        "NOCOBASE_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

/absolute/path/to/nocobase-mcp-serverを、リポジトリをクローンした実際のパス（例: /Users/yourname/Projects/nocobase-mcp-server）に置き換えてください。

環境変数

APIトークンの取得

1. NocoBase UIで: 設定 → プラグイン → API keysプラグインを有効化

2. 設定 → API keys → APIキーを追加 に移動

3. 生成されたトークンをコピー

動的ツールの有効化（オプション）

NocoBaseでAPIドキュメントプラグインを有効にします（設定 → プラグイン）。有効にすると、サーバー起動時にすべての追加APIエンドポイントがツールとして自動的に読み込まれます。

ツールリファレンス

コレクション

UIスキーマ（クラシックページ）

デスクトップルート / ナビゲーション

フ