Nocodb MCP Server

Nocodb MCP サーバー

はじめに

NocoDB MCP サーバーを使うと、Model Context Protocol（MCP）を介してNocoDBデータベースをシームレスに操作できます。このサーバーを使用すると、自然言語のコマンドでNocoDBのテーブルに対するCRUD（作成、読み取り、更新、削除）操作を簡単に実行できます。

プロンプトの例

[Get Records]
get data from nocodb, table: Shinobi

[Create Record]
add new row, with name: sasuke-2
add other row, with name: naruto-2

[Update Record]
update all rows, remove suffix -

[Delete Record]
delete all rows with name naruto

[Add Column]
add column with name: Age

update all rows, set Age to 18

[Delete Column]
delete column with name: Age

プロンプトの例 - ファイルのアップロード

[Create table]
from the json files
put on nocodb database
table name is TableShinobi

JSONのファイルの場所：example_upload.json

プロンプトの例 - レコードの一括作成と一括削除

このフォークについて

このリポジトリは、NocoDB-MCP-ServerをTypeScriptで実装したフォークです。コア機能を維持しながら、保守性を高め、最新のTypeScript開発手法との互換性を向上させています。

ホステッドデプロイ

Frontier AIでホステッドデプロイを利用できます。

セットアップ

Node.jsとTypeScriptがインストールされていることを確認してから、次を実行します。

npm install
npm run build

設定

必要な環境変数を.envファイルに定義します。

NOCODB_URL=https://your-nocodb-instance.com
NOCODB_API_TOKEN=your_api_token_here
NOCODB_BASE_ID=your_base_id_here

**ヒント：**テンプレートはenv.exampleからコピーして、値を入力できます。

NOCODB_BASE_IDの取得方法

NOCODB_BASE_IDを確認するには、NocodbインスタンスのURLを確認します。
例： https://app.nocodb.com/#/wi6evls6/pqmob3ammcknma5/maty9c5xkmf4012
このURL形式では：

https://app.nocodb.com/#/{USERNAME}/{NOCODB_BASE_ID}/{TABLE_ID}

Claude Desktopとの統合

claude_desktop_config.jsonを変更して、次を含めます。

{
  "mcpServers": {
    "nocodb": {
      "command": "node",
      "args": ["{working_folder}/dist/start.js"],
      "env": {
        "NOCODB_URL": "https://your-nocodb-instance.com",
        "NOCODB_BASE_ID": "your_base_id_here",
        "NOCODB_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

CLIから直接呼び出す

コマンドラインからMCPサーバーを直接呼び出せます。
必須パラメーターはNOCODB_URL、NOCODB_API_TOKEN、NOCODB_BASE_IDです。
NocoDBクラウドを使用している場合は、NOCODB_URL=https://app.nocodb.comを指定します。

npx -y nocodb-mcp-server {NOCODB_URL} {NOCODB_BASE_ID} {NOCODB_API_TOKEN} 

CLIでのテスト

テストを実行するには、次を実行します。

npx -y @wong2/mcp-cli npx nocodb-mcp-server {NOCODB_URL} {NOCODB_BASE_ID} {NOCODB_API_TOKEN} 

API関数

利用可能なAPI関数の詳細については、API_FUNCTION.mdを参照してください。

プロジェクト構成

/project-root
  ├── src/            # TypeScript source files
  ├── dist/           # Compiled JavaScript output
  ├── .env            # Environment variable configurations
  ├── package.json    # Project dependencies and scripts
  ├── tsconfig.json   # TypeScript settings

貢献ガイドライン

貢献を歓迎します。お気軽にイシューを作成するか、プルリクエストを送信してください。

ライセンス

このプロジェクトはMITライセンスで配布されています。