MCP Server Guide & Examples

MCP サーバーガイドと使用例

Model Context Protocol（MCP）サーバーの構築に関する包括的なガイドと実装例をまとめています。このリポジトリでは、Python と TypeScript を中心に、複数の言語で MCP サーバーを作成する方法を紹介しています。

🚀 特長

• サーバーの実装例：

  • 非同期処理に対応した Python の最小構成のサーバー
  • ES モジュールを使用した TypeScript の最小構成のサーバー
  • どちらの実装でも MCP の基本概念を紹介

• コア機能の使用例：

  • ツール（calculate、fetch-json、ファイル I/O）
  • リソース（静的および動的）
  • プロンプトとテンプレート
  • ロギングとエラー処理

• セキュリティとベストプラクティス：

  • サンドボックス化されたファイル操作
  • エラー処理のパターン
  • ロギングの戦略
  • 型安全性（TypeScript／Pydantic）

📚 ドキュメント

• サーバーガイド - メインのドキュメントとチュートリアル
• Python の使用例 - Python の実装の詳細
• TypeScript の使用例 - TypeScript の実装の詳細

🛠️ クイックスタート

1. お好みの実装を選択します：

   # Python
   cd examples/python-minimal
   pip install -r requirements.txt
   python server.py
   
   # TypeScript
   cd examples/typescript-minimal
   npm install
   npm run build
   npm start
   

2. MCP CLI を使用して接続します：

   mcp-cli connect
   

📋 前提条件

• Python 3.8+（Python の使用例）
• Node.js 16+（TypeScript の使用例）
• MCP CLI ツール（npm install -g @modelcontextprotocol/cli）

🤝 貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

📄 ライセンス

このプロジェクトは ISC ライセンスの下で公開されています。詳細については LICENSE ファイルをご覧ください。