mcpField
D
demo-mcp-server MCP Server

demo-mcp-server MCP Server

ローカル
github.com/xu1211開発ツール082 週間前に更新

demo-mcp-server MCP Server について

プロジェクト管理を題材にした TypeScript 製の MCP サーバーのサンプルです。ローカルプロジェクトの作成やオープンを行う AI クライアント向けに、リソースとツールを提供します。

主な機能

  1. 01project:// URI によるプロジェクト一覧
  2. 02プロジェクト名・パス・メタデータの取得
  3. 03テキストプロジェクトの作成
  4. 04プログラムからのプロジェクトのオープン

活用シーン

  1. 01AI クライアントから利用可能なプロジェクトを確認
  2. 02タイトルと内容を指定してプロジェクトを作成
  3. 03AI クライアントにプロジェクトを開かせる

MCP 対応

MCP クライアントにプロジェクトのリソースと、create_project および open_project ツールを提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"demo-mcp-server-xu1211": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/inspector"
]
}
}
}
起動コマンドnpx -y @modelcontextprotocol/inspector

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@modelcontextprotocol/inspector

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

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": []
    }
}

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。