MCP Server Coding Demo Guide について
MCP Server Coding Demo Guideは、外部APIを使った基本的なMCPサーバーの作成・設定手順を示すガイドです。ツール設定、API認証、ビルド、チャットアプリとの接続、テストまでを扱います。
主な機能
- 01テンプレートとAPIサンプルのソース確認
- 02APIの選択と設定
- 03サーバーツールとパラメーターの定義
- 04npmスクリプトでのビルド
- 05チャットアプリ接続の設定
- 06サーバーのテスト
活用シーン
- 01APIエンドポイントをMCPツールとして利用
- 02APIキーとリクエストヘッダーの設定
- 03ビルドしたサーバーをチャットアプリに接続
MCP 対応
APIを呼び出すMCPサーバーを作成し、その機能をツールとしてチャットアプリに提供する方法を説明します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
MCP サーバーのコーディングデモガイド
ステップ 1:リポジトリをクローンする
- 整理しやすいように、MCP サーバーを保存するフォルダーをデバイス上に作成します。
- そのフォルダーにリポジトリをクローンします。
ステップ 2:ソースファイルを確認する
srcフォルダーに移動し、次のファイルを確認します。index.ts:変更が必要な基本テンプレートのサーバーです。demo.ts:API 連携を実演する、動作するサンプルです。
ステップ 3:API を選択する
- RapidAPI にアクセスし、使用する API とエンドポイントを見つけます。
- アクセス権と認証キーを取得します。リクエストの構成方法を把握するため、出力例を確認します。
- 正しいヘッダー、認証情報、リクエストパラメーターを取得してください。
注: 評価が高く、出力が明確な API を使うことをおすすめします。信頼性を確保するためです。
ステップ 4:デモを設定する
- サーバー名を定義する - 自分やエンドユーザーが認識しやすい名前を選びます。
- ツールを定義する:ユースケースに合った名前を選びます。パラメーターを収集し、必要なものは必須として指定します。
- リソースを設定する:
- API が正しく呼び出されることを確認します。認証ヘッダーとエンドポイント URL を設定します。
- リクエストに正しいデータを渡します。
- 注 - 認証を正しく処理します(MCP の設定内、または
.envファイル内で行います)。
ステップ 5:インストールしてビルドする
- まだインストールされていない場合は、依存関係をインストールします。
npm install npm run build
ステップ 6:チャットアプリを設定する
- サンプル設定をベースにして、次の項目を編集します。
- ビルドファイルの場所に合わせてビルドパスを設定します。
- 適切なツール名を設定します。
- コマンドが正しいことを確認します。
- API キーを ENV 値として入力します。
- クラウドデスクトップまたは 5ier の設定用に、設定ファイルを保存します。
- ~/Library/Application Support
- 変更を適用するため、チャットアプリを再起動します。
{
"stock": {
"command": "node",
"args": ["users/mcp-servers/mcp-server-demo-1/build/demo.js"],
"env": {
"RAPIDAPI_KEY": "XXX-XXX-XXX-XXX-XXX-XXX-XXX-XXX-XXX"
},
"disabled": false,
"autoApprove": []
}
}
ステップ 8:セットアップをテストする
- チャットを開始し、サーバーが想定どおりに動作することを確認します。
デバッグとトラブルシューティング
ヘルプ!
Claude Desktop で MCP を設定する(ユーザーガイド)
https://modelcontextprotocol.io/quickstart/user
MCP サーバーのクイックスタートガイドを作成する(開発者ガイド)
https://modelcontextprotocol.io/quickstart/server
MCP 101 と MCP サーバーの構築
https://glama.ai/blog/2024-11-25-model-context-protocol-quickstart
TS MCP SDK
https://github.com/modelcontextprotocol/typescript-sdk
5ire - 5ire に MCP を追加する方法
- アプリケーションサポートフォルダーを開き、MCP 設定ファイルを編集します。
https://5ire.app/docs
コードに自信がありませんか? - Cline Way を試してみましょう
- VS Code に Cline をインストールします。https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev
- API キーを Cline に追加します
- 高性能なモデル(Claude3.5、Deepseek、Gpt4o、Gemini Pro)を選択します
- 新しいディレクトリを作成し、MCP サーバーを構築するよう cline に指示します。
- リポジトリに含まれているサンプルプロンプトを使用できます。
追加情報
- 特定のデバッグリソースやチャットアプリの設定へのリンクを追加する予定です。
- MCP サーバーは Klein 内で直接デプロイしてテストできます。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。