MCP Server: Demo

MCP サーバー：デモ

概要

このリポジトリは、実際のデータベース情報にアクセスしてクエリを実行できる MCP（Model Context Protocol）サーバーの構築例を示します。Cloudflare の MCPAgent を活用する @modelcontextprotocol/sdk ライブラリを使用して、ツールの実装、リソースの管理、D1 データベースとの連携を行います。

機能

データベース

このプロジェクトは、データを取得するために D1 データベース（mcp-agent-d1-data）と連携していますが、ツールに少し調整を加えれば、ほかのデータベースでも利用できます。また、次の便利な機能も含まれています。

• スキーマ管理：db/ ディレクトリ内の SQL マイグレーションファイル（up.sql、down.sql、seed.sql）で、データベースのスキーマと初期データを管理します。

MCP サーバー（MyMCP）

MyMCP クラスは、@modelcontextprotocol/sdk ライブラリの McpAgent クラスを拡張しています。サーバーの中核となる実装として、基盤となるトランスポートにサーバー送信イベント（SSE）を提供します。

• Durable Object：サーバーは Durable Object として実装されており、ステートフルなやり取りや長時間の処理が可能です。また、アイドル時には組み込みのハイバネーション機能が動作します。

クエリツール

query ツールは、LLM がデータベースに SQL クエリを送信できるインターフェースを提供し、データベースとのやり取りを行います。本番環境で使用する際は注意し、適切な認可対策を講じてください。

イントロスペクションツール

schema-introspection ツールは、LLM がデータベースの構造を理解し、より正確なクエリ設計を行うために役立ちます。

統合テスト

すぐに利用を開始できる統合テストが tests/ ディレクトリに含まれています。MCP サーバーとそのツールの機能を検証したり、TDD に活用したりできます。

npm run test

プロジェクト構成

📦 d1-mcp
├── package.json
├── README.md
├── tsconfig.json
├── vitest.config.js
├── worker-configuration.d.ts
├── wrangler.jsonc
├── db
│   ├── down.sql
│   ├── seed.sql
│   └── up.sql
├── public
│   └── index.html
├── src
│   ├── index.ts
│   ├── metadata.ts
│   ├── tools.ts
│   └── utils.ts
└── tests
    ├── index.test.ts
    └── tsconfig.json

はじめに

前提条件

• Node.js
• Cloudflare Workers CLI（wrangler）

インストール

1. リポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

開発

• 開発サーバーを起動します。

  npm run dev
  

デプロイ

• Cloudflare Workers にデプロイします。

  npm run deploy
  

ライセンス

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