MOCO MCP Server

手動でエンドポイントを定義する代わりに、このサーバーは公式のMOCO OpenAPI仕様（openapi/ディレクトリに同梱）と完全なスキーマ参照パーサーを使用して、利用可能なすべてのMCPツールを自動生成します。これにより、MCP互換のLLM（Claudeなど）は、正確なツール説明とパラメータスキーマを備えたMOCO API v1のすべての読み取り・書き込み操作（GET、POST、PUT、DELETE）に即座にアクセスできます。

Levisteria GbR（Eddy Lackmann）によって開発・保守されています。

機能

• 完全なAPIカバレッジ: タイムトラッキング、プロジェクト、請求書、連絡先、その他すべてのMOCOエンドポイント向けのツールを自動生成します。

• セーフティモード: 環境変数を使用してREAD_ONLYに制限し、LLMによる誤ったデータ変更を防ぐことができます。

• 常に最新: サーバー起動のたびにMOCOから最新のAPI仕様を取得します。

• 簡単な実行: npxで直接実行できます。

Related MCP server: Odoo MCP Server

前提条件

• Node.js (v24以上)

• MOCOアカウント (<your-account>.mocoapp.com)

• MOCO APIキー (MOCOの「プロフィール > 統合」で確認できます)

クイックスタート (npx)

グローバルにインストールせずにサーバーを直接実行できます:

export MOCO_DOMAIN="your-account-name"
export MOCO_API_KEY="your-api-key"
npx -y @levisteria-solutions/moco-mcp-server

Claude Desktop / Cursorでの設定

MCP設定にサーバーを追加します（例: Claude DesktopまたはCursor）。

npxを使用する場合（ローカル利用におすすめ）

{
  "mcpServers": {
    "moco": {
      "command": "npx",
      "args": ["-y", "@levisteria-solutions/moco-mcp-server"],
      "env": {
        "MOCO_DOMAIN": "your-account-name",
        "MOCO_API_KEY": "your-api-key",
        "MOCO_READ_ONLY": "false"
      }
    }
  }
}

## Environment Variables

| Variable | Description | Example |
|----------|-------------|---------|
| `MOCO_DOMAIN` | Your MOCO subdomain (without `.mocoapp.com`) | `mycompany` |
| `MOCO_API_KEY` | Your personal or account API Key | `12345abcdef...` |
| `MOCO_READ_ONLY` | If `true`, only GET requests (reading) are allowed. POST/PUT/DELETE are blocked. | `true` or `false` |

## Development

1. Clone the repository:
```bash
git clone https://github.com/levisteria/moco-mcp-server.git
cd moco-mcp-server

2. 依存関係をインストール:

npm install

3. プロジェクトをビルド:

npm run build

4. ローカルで実行:

npm start

仕組み

1. サーバーはopenapi/ディレクトリから同梱のMOCO OpenAPI仕様を読み込みます。

2. @apidevtools/swagger-parserを使用してすべての$refリンクを解決し、完全かつ正確なJSONスキーマを保証します。

3. すべてのパス（例: /activities）とメソッド（例: GET、POST）を解析し、その要約と説明を抽出します。

4. パラメータとリクエストボディをMCPが理解できるJSONスキーマに変換します。

5. 生成されたツールは、例えばget_activitiesやpost_activitiesのように命名されます。

6. LLMがツールを呼び出すと、サーバーは認証済みリクエストをMOCOに転送し、JSON結果を返します。

ライセンス

MITライセンス