MCP Sample Server

シンプルなModel Context Protocol (MCP)サーバーのサンプル実装です。

関連プロジェクト

• MCPクライアント: このサーバーと対話するための自然言語クライアント

  • OpenAI APIを使用して自然言語でMCPツールを実行

  • GitHubリポジトリ: yukinaka/mcp-client

  • ローカルパス: ../mcp-client/

機能

このMCPサーバーは以下の機能を提供します：

ツール

1. get_current_time - 現在の時刻を取得

   • パラメータ: timezone (オプション) - タイムゾーン（例: Asia/Tokyo, UTC）

2. calculate - 簡単な計算を実行

   • パラメータ:

     • operation - 演算の種類（add, subtract, multiply, divide）

     • a - 最初の数値

     • b - 2番目の数値

リソース

• サンプルノートへのアクセス（note:///welcome, note:///example）

インストール

前提条件

• Node.js (v18以上)

• npm または yarn

ローカル開発

npmパッケージとしてインストール（公開後）

使い方

MCPクライアントで使用する（推奨）

このサーバーには、OpenAI APIを使用した自然言語クライアントが付属しています。

詳細はmcp-client/README.mdを参照してください。

Claude Codeで使用する

.claude/settings.local.json に以下の設定を追加します：

開発版（ローカル）を使用する場合

GitHubから直接使用する場合

npmパッケージとして使用する場合（公開後）

他のMCPクライアントで使用する

Claude Desktop等の他のMCPクライアントでも同様に設定できます。クライアントの設定ファイルに上記のような設定を追加してください。

開発

ウォッチモード

テスト実行

GitHub公開手順

1. GitHubで新しいリポジトリを作成

2. ローカルでGitリポジトリを初期化:

3. （オプション）npmに公開:

カスタマイズ

このサンプルをベースに、独自のツールやリソースを追加できます：

• src/index.ts の tools 配列に新しいツールを追加

• CallToolRequestSchema ハンドラーに実装を追加

• リソースを追加する場合は resources 関連のハンドラーを修正

ライセンス

MIT

参考リンク

• MCP公式ドキュメント

• MCP SDK