demo-mcp-server MCP Server について
プロジェクト管理を題材にした TypeScript 製の MCP サーバーのサンプルです。ローカルプロジェクトの作成やオープンを行う AI クライアント向けに、リソースとツールを提供します。
主な機能
- 01project:// URI によるプロジェクト一覧
- 02プロジェクト名・パス・メタデータの取得
- 03テキストプロジェクトの作成
- 04プログラムからのプロジェクトのオープン
活用シーン
- 01AI クライアントから利用可能なプロジェクトを確認
- 02タイトルと内容を指定してプロジェクトを作成
- 03AI クライアントにプロジェクトを開かせる
MCP 対応
MCP クライアントにプロジェクトのリソースと、create_project および open_project ツールを提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
demo-mcp-server MCP サーバー
Model Context Protocol サーバー
プロジェクト管理システムを通じてコアコンセプトを実演する、TypeScript ベースの MCP サーバーです。主なコンポーネント:
リソース:URI と階層パスを使ってプロジェクトをクエリします ツール:プログラムからプロジェクトを作成して開きます
目標:AI にプロジェクトを開くよう伝えると、AI が MCP サーバーを呼び出してプロジェクトを開き、ローカルで実行します
機能
リソース
project://URI を使ってプロジェクトを一覧表示し、アクセスします- 各プロジェクトには、プロジェクト名、パス、メタデータがあります
- シンプルにコンテンツへアクセスできるプレーンテキストの MIME タイプ

ツール
create_project- 新しいテキストプロジェクトを作成します- 必須パラメーターとしてタイトルとコンテンツを受け取ります
- プロジェクトをサーバーの状態に保存します
open_project- プロジェクトを開きます

開発
- 依存関係をインストールします:
npm install
- サーバーをビルドします:
npm run build
- 自動リビルドを有効にした開発の場合:
npm run watch
- デバッグ
MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします:
npx @modelcontextprotocol/inspector node .../demo-mcp-server/build/index.js
Inspector から、ブラウザーでデバッグツールにアクセスするための URL が提供されます。
インストール
Claude Desktop で使用するには、サーバー設定を追加します:
MacOS の場合:~/Library/Application Support/Claude/claude_desktop_config.json
Windows の場合:%APPDATA%/Claude/claude_desktop_config.json
{
"demo-mcp-service": {
"command": "/usr/local/bin/node",
"args": [
".../demo-mcp-server/build/index.js"
],
"disabled": false,
"autoApprove": []
}
}
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。