Microcms Api MCP Server

🚀 microCMS MCP サーバー

このプロジェクトは、Model Context Protocol (MCP) を使用して、microCMS API にアクセスするサーバーを実装しています。

🚀 クイックスタート

microCMS MCP サーバーは、指定されたエンドポイントからのコンテンツ取得や、ID を使った特定のコンテンツの取得、キーワードによるコンテンツ検索、複雑な条件に基づくコンテンツのフィルタリングなどの機能を提供します。

✨ 主な機能

• コンテンツリストの取得：指定されたエンドポイントからコンテンツリストを取得します。
• 特定コンテンツの取得：ID を使って特定のコンテンツを取得します。
• コンテンツ検索：キーワードに基づいてコンテンツを取得します。
• フィルター検索：複雑な条件に基づいてコンテンツをフィルタリングします。

📦 インストール

# リポジトリをクローンする
git clone https://github.com/burnworks/microcms-api-mcp-server
cd microcms-api-mcp-server

# 依存関係をインストールする
npm install

💻 使用例

基本的な使用法

必要なファイルを構築する

# TypeScript をコンパイルする
npm run build

dist/ ディレクトリに必要なファイルが生成されます。

MCP クライアントから使用する

このサーバーは MCP プロトコルに準拠しており、任意の MCP クライアントから接続して使用することができます。

Claude デスクトップアプリでの設定

claude_desktop_config.json に以下の設定を追加してください。

{
  "mcpServers": {
    "microcms": {
      "command": "node",
      "args": [
        "/[__path__]/microcms-api-mcp-server/dist/index.js"
      ],
      "env": {
        "MICROCMS_API_KEY": "__your_api_key_here__",
        "MICROCMS_BASE_URL": "https://your-service.microcms.io"
      }
    }
  }
}

Windows 環境では、設定は次のようになる場合があります。

{
  "mcpServers": {
    "microcms": {
      "command": "C:/Program Files/nodejs/node.exe",
      "args": [
        "C:/[__path__]/microcms-api-mcp-server/dist/index.js"
      ],
      "env": {
        "MICROCMS_API_KEY": "__your_api_key_here__",
        "MICROCMS_BASE_URL": "https://your-service.microcms.io"
      }
    }
  }
}

📚 ドキュメント

利用可能なリソース

• microcms://{endpoint}/{contentId}：特定の ID のコンテンツを取得するためのリソース URI テンプレートです。
• microcms://{endpoint}：コンテンツリストを取得するためのリソース URI テンプレートです。

📄 ライセンス

MIT