🌐 Claude MCP Server Quickstart について
Claude モデルをアプリケーションに接続するための Python 製 MCP サーバーのクイックスタートです。コンテキストを考慮したリクエストとストリーミング応答を示し、Claude Desktop での利用例として天気情報を扱います。
主な機能
- 01MCP プロトコルの実装
- 02Claude モデルとの接続
- 03コンテキストを考慮したリクエスト処理
- 04ストリーミング応答への対応
- 05Claude Desktop の設定ガイド
活用シーン
- 01Claude Desktop とサンプルサーバーの接続
- 02Claude 経由での天気情報の問い合わせ
MCP 対応
Claude Desktop から起動して接続できる MCP サーバーを実装しています。README には天気情報の問い合わせ例がありますが、公開するツールの詳細は記載されていません。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
🌐 Claude MCP サーバーのクイックスタート
Claude AI モデルと連携する、すぐに使えるModel Context Protocol(MCP)サーバーの実装です。
🔍 概要
このプロジェクトでは、次のことができる、完全に機能する MCP サーバーの実装を提供します。
- 標準化されたプロトコルを通じて Claude AI モデルに接続する
- コンテキストを考慮したリクエストを処理する
- モデルの応答を効率的に処理する
- アプリケーションでの AI 統合を簡素化する
公式のMCP Server Quickstart guideに従って構築されています。
✨ 機能
- ✅ 完全な MCP プロトコルの実装
- ✅ Claude AI モデルとの統合
- ✅ コンテキストを考慮したリクエスト処理
- ✅ ストリーミング応答のサポート
- ✅ 簡単な設定とセットアップ
- ✅ ドキュメントが充実したコードベース
📋 前提条件
- Python 3.8+
- Claude AI API の認証情報へのアクセス
- REST API の基本的な知識
🚀 インストール
# Clone the repository
git clone https://github.com/gabrieldsguilherme/mcp-server.git
cd mcp-server
# Create and activate virtual environment
uv venv
source .venv/bin/activate
# Install dependencies
uv add "mcp[cli]" httpx
⚙️ 設定
1. Claude Desktop の設定ファイルを開く
テキストエディターで、~/Library/Application Support/Claude/claude_desktop_config.json にある Claude for Desktop App の設定ファイルを開きます。ファイルが存在しない場合は、必ず作成してください。
2. Claude Desktop の設定ファイルを更新する
{
"mcpServers": {
"weather": {
"command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather",
"run",
"weather.py"
]
}
}
}
これにより、Claude for Desktop に次のことを伝えます。
a. 「weather」という名前の MCP サーバーがあること
b. uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/weather run weather.py を実行して起動すること
3. ファイルを保存して Claude for Desktop を再起動する
📖 使用方法
1. Claude に「サクラメントの天気は?」と尋ねます
2. Claude に「テキサス州で現在発令されている気象警報は?」と尋ねます
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。