Hello-MCP 🚀

Hello-MCP 🚀

---

中文文档 🇨🇳

MCP（Model Control Protocol）クライアントとサーバーのシンプルな実装です。 MCP プロトコルとは何か、どのように動作するのかを理解するのに役立ちます。

このプロジェクトでできること ✅：

• MCP プロトコルの本質を学べます
• 独自の MCP クライアントとサーバーを構築できます
• MCP の実装を実際に体験できます

このプロジェクトで扱わないこと ❌：

• 既存の MCP ホストの設定方法は扱いません
• 汎用サーバー機能は実装しません（ご自身で調べて実装してください）

機能 ✨

MCP クライアント

• MCP サーバーの登録に対応しています（SSE と stdio の両方に対応）
• 対話型のコマンドラインチャットインターフェース
• DeepSeek API での会話に対応しています（設定ファイルで API キーを設定してください）
• ストリーミング形式で応答を出力します

MCP サーバー

• FastMCP をベースにしたシンプルなサーバー（SSE と stdio の両方に対応）
• 基本的なパスユーティリティを提供します（指定したパス内のすべてのファイルを一覧表示します）
• ヘルスチェックに対応しています

デモ

List_Dir ツールを使ってファイルを取得し、分析しましょう！

使い方 📖

環境のセットアップ

プロジェクト管理には uv の使用をおすすめします

0. プロジェクトをクローンする

git clone https://github.com/Cookie-HOO/hello-mcp.git
cd hello-mcp

1. uv をインストールする

uv の公式インストールドキュメント

macOS：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows（PowerShell が必要です）：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. プロジェクトの依存関係を初期化する

uv venv  # Create virtual environment
uv sync  # Install dependencies
source ./.venv/bin/activate  # macOS: activate virtual environment
.\.venv\Scripts\activate     # Windows: activate virtual environment

3. DeepSeek API キーを設定する

現在、DeepSeek API のみサポートしています。以下から申請してください： DeepSeek API プラットフォーム

cp ./config.example.yaml ./config.yaml
# Edit to add your DeepSeek API key

4. プロジェクトを実行する

# Method 1: stdio (only need to explicitly start client)
python -m hello_mcp.client2stdio --server-path ./hello_mcp/server.py

# Method 2: SSE (need to explicitly start both server and client)
python -m hello_mcp.server --transport sse  # Start server in SSE mode
python -m hello_mcp.client2sse --server-url http://127.0.0.1:8000  # Register the MCP server with client

MCP サーバーのデバッグ

uv run mcp dev hello_mcp/server.py

ライセンス 📜

MIT ライセンスです。詳細は LICENSE ファイルをご覧ください。

👋 コントリビューションを歓迎します！お気軽に issue やディスカッションを投稿してください。

MCP の使い方 🛠️

1. 日常業務で MCP を使う方法

1. ニーズに合った MCP サーバーホストを探します
2. MCP サーバーを設定します

MCP ホストの参考リスト：

クライアント	リソース	プロンプト	ツール	サンプリング	ルート	備考
5ire	❌	❌	✅	❌	❌	ツールに対応しています。
Apify MCP Tester	❌	❌	✅	❌	❌	ツールに対応しています
BeeAI Framework	❌	❌	✅	❌	❌	エージェント型ワークフローでのツールに対応しています。
Claude Code	❌	✅	✅	❌	❌	プロンプトとツールに対応しています
Claude Desktop App	✅	✅	✅	❌	❌	ツール、プロンプト、リソースに対応しています。
Cline	✅	❌	✅	❌	❌	ツールとリソースに対応しています。
Continue	✅	✅	✅	❌	❌	ツール、プロンプト、リソースに対応しています。
Copilot-MCP	✅	❌	✅	❌	❌	ツールとリソースに対応しています。
Cursor	❌	❌	✅	❌	❌	ツールに対応しています。

2. MCP ツールの探し方

リソース	推奨度
Smithery - Model Context Protocol Registry	🌟🌟🌟
https://github.com/punkpeye/awesome-mcp-servers	🌟🌟🌟
https://github.com/modelcontextprotocol/servers	🌟🌟🌟
すべての MCP サーバーの一覧（42）| Portkey	🌟🌟
https://cursor.directory/mcp	🌟🌟
オープンソース MCP サーバー | Glama	🌟🌟
https://mcp.so/	🌟🌟
https://www.pulsemcp.com/servers	🌟🌟
Awesome MCP Servers	🌟🌟

MCP の概念に関する Q&A ❓

Q: MCP はどのような問題を解決しますか？

A: MCP（Model Control Protocol）が対応する内容は次のとおりです。

1. AI モデルのインタラクションプロトコルの標準化
2. 統一されたツール呼び出し仕様の提供
3. 複雑な AI システムの統合の簡素化
4. モデル機能のモジュール化と再利用の実現

Q: MCP の歴史

A: MCP の開発の経緯は次のとおりです。

1. 2023年：Anthropic（Claude の親会社）がコンセプトを発表
2. 2024年：複数のオープンソース実装が登場
3. 2025年：AI システム統合の標準プロトコルとなる
4. 現在：さまざまな AI エージェントシステムで広く使用されている

Q: MCP の現状

A: 主な利用シナリオは次のとおりです。

1. AI アシスタントシステム
2. 自動化されたワークフロー
3. マルチモデル連携プラットフォーム
4. エンタープライズ向け AI ソリューション 一般的な実装には FastMCP、PyMCP などがあります。

---

Q: MCP と Function Call の違い

A: 共通点：

1. どちらも特定の関数を実行します
2. どちらも入出力の定義が必要です 相違点：
3. MCP は標準化されたプロトコルであり、Function Call は言語機能です
4. MCP は言語やプラットフォームをまたいだ呼び出しに対応しています
5. MCP には、完全なツールの検出と登録の仕組みが含まれています

Q: MCP とエージェントの関係

A: 主なポイント：

1. エージェントは MCP を使用する主体です
2. MCP はエージェント同士、またはエージェントとツール間のインタラクションに使われるプロトコルです
3. 1つのエージェントに複数の MCP ツールを登録できます

プロジェクトに関する Q&A 💡

Q: DeepSeek API キーの設定に関する問題を解決するには？

A: 次の点を確認してください。

1. config.yaml の api_key フィールドに正しい値が入力されている
2. キーに余分な空白や引用符が含まれていない
3. 認証に失敗する場合は、API キーを再生成してみる

Q: サーバーの起動時にポートがすでに使用されています

A: 解決方法：

1. lsof -i :8000 でポートを使用しているプロセスを確認する
2. プロセスを終了するか、サーバーのポートを変更する
3. クライアントの登録 URL を更新する

Q: 新しい MCP ツールを追加するには？

A: 手順：

1. server.py に新しいツール関数を追加する
2. @tool デコレーターで登録する
3. 入力パラメーターのスキーマを定義する
4. クライアントからの呼び出しをテストする

Q: uv sync コマンドが失敗します

A: 考えられる解決方法：

1. ネットワーク接続を確認する
2. 依存関係の競合がある場合は、.venv を削除して再作成する
3. sudo を使用するか、ディレクトリのアクセス権を修正する

Q: コードに貢献するには？

A: GitHub での PR を歓迎します。

1. プロジェクトをフォークする
2. 機能ブランチを作成する
3. 内容が明確なメッセージを付けてコミットする
4. Pull Request を作成する