MCP Forge

🚀 MCP-Forge

MCP-Forgeは、新しいMCP（モデルコンテキストプロトコル）サーバープロジェクトを迅速に構築するためのスケルトンツールです。このツールは、サンプルツール、リソース、テストツールを含む構造が整ったプロジェクトを生成し、サーバーの機能構築に集中できるようにします。

⚠️ 重要提示

これはMCP-Forgeの早期バージョンです。API、生成される構造、および機能は、MCPエコシステムの進化に伴って変更される可能性があります。フィードバックとコントリビューションを歓迎します！

🚀 クイックスタート

MCP-Forgeを使用することで、MCPサーバープロジェクトを迅速に構築できます。以下に、基本的な使用方法を説明します。

✨ 主な機能

• MCPサーバー用の完全なPythonプロジェクト構造を生成します。
• 統一されたサーバーエントリポイントを提供し、--modeパラメータでSSEとstdioの伝送モードを選択できます。
• サンプルツール（AddNumbers、DateDifferenceなど）とリソース（HelloWorld、UserProfile）を含んでいます。
• Pydanticモデルを使用して、明確な入力/出力アーキテクチャを定義します。
• uvを使用して依存関係管理とタスク実行を行います。

📦 インストール

uvx（uvから）を使用することをおすすめします。これは一時的な環境を処理します。

# 確認してuvがインストールされていること
uvx mcp-forge --help

または、pipを使用してグローバルにインストールするか、専用の環境で使用することもできます。

pip install mcp-forge
mcp-forge --help

💻 使用例

基本的な使用法

新しいプロジェクトの作成

新しいMCPサーバープロジェクトを作成するには、以下のコマンドを実行します。

mcp-forge new my-awesome-server
cd my-awesome-server

サーバーの起動

サーバーを起動するには、以下のコマンドを実行します。

uv run python -m my_awesome_server.server --mode=sse

または、プロジェクトディレクトリに入っている場合は、以下のコマンドを使用できます。

my-awesome-server --mode=sse  # SSEモードで実行（HTTPサービスは0.0.0.0:6969）
my-awesome-server --mode=stdio # stdioモードで実行

プロジェクト構造

生成されるプロジェクト構造は次のとおりです。

my_awesome_server/
├── server.py             # メインサーバーファイル
├── tools/               # カスタムツールディレクトリ
│   └── __init__.py      # ツール初期化ファイル
├── resources/           # リソースディレクトリ
│   └── __init__.py      # リソース初期化ファイル
└── requirements.txt     # プロジェクト依存関係管理ファイル

サポート開発

このプロジェクトが役に立った場合は、寄付を通じて開発をサポートすることを検討してください。 あなたのサポートは、このプロジェクトの維持と改善に役立ちます！

関連情報

MCPについて

モデルコンテキストプロトコル（MCP）は、言語モデル（またはその他のクライアント）と外部ツール/サービス（サーバー）間の通信を実現するための規格です。サーバーが標準的な方法でツールとリソースを公開する方法を定義しています。 詳細については、MCP公式ドキュメントを参照してください。

貢献

MCP-Forgeへの貢献を歓迎します！これは早期のプロジェクトであり、改善や新機能の余地がたくさんあります。

1. リポジトリをフォークします（mcp-forge）
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m '素敵な機能を追加'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを開きます

📄 ライセンス

このプロジェクトはMITライセンスの下でオープンソース化されています。詳細については、生成されたLICENSEファイルまたはソースリポジトリを確認してください。