Forge MCP Server

Forge MCP サーバー

Forge プロジェクトのスキャフォールディングエージェント向けの Model Context Protocol（MCP）サーバーです。このサーバーは、大規模言語モデル（LLM）と Forge API をつなぐブリッジとして機能し、AI アシスタントがユーザーの要件に基づいて新しいプロジェクトをスキャフォールディングできるようにします。

概要

Forge MCP Server は FastMCP フレームワークを使用し、LLM が Forge プロジェクトスキャフォールディング API とやり取りするためのツールを作成します。これにより、AI アシスタントは自然言語による説明に基づいて、プロジェクト構成、ボイラープレートコード、設定を生成できます。

機能

• Model Context Protocol を使用して LLM と簡単に連携
• Forge プロジェクトスキャフォールディング API への接続
• プロジェクト生成のためのシンプルなクエリーインターフェース
• エラー処理とタイムアウト管理

前提条件

• Python 3.13+
• Pipenv

インストール

リポジトリをクローンします：

git clone https://github.com/believemanasseh/forge-mcp.git
cd forge-mcp

依存関係をインストールします：

pipenv --python 3.13
source .venv/bin/activate
pipenv install

開発

サーバーの実行

fastmcp dev server.py

サーバーはデフォルトで通信に stdio を使用するため、さまざまな LLM 統合フレームワークと互換性があります。

API リファレンス

query_agent

リクエストクエリーを Forge API に送信し、結果を返します。

パラメーター：

• query（string）：スキャフォールディングするプロジェクトの自然言語による説明

戻り値：

• Forge API からの JSON レスポンス

例：

query_agent("Create a Django project named deet.")

MCP ホストとの連携

Cursor または Windsurf との連携

次の設定ファイルを更新します：

• Cursor：~/.cursor/mcp.json または .cursor/mcp.json
• Windsurf：~/.codeium/windsurf/mcp_config.json

{
    "mcpServers": {
        "forge-mcp": {
            "command": "pipenv",
            "args": ["run", "fastmcp", "run", "server.py"],
            "transport": "stdio"
        }
    }
}

Claude Desktop との連携

Claude Desktop で、Settings > Developer > Edit Config に移動します。設定を次の内容に置き換えます：

{
    "mcpServers": {
        "forge-mcp": {
            "command": "pipenv",
            "args": [
                "run",
                "fastmcp",
                "run",
                "server.py"
            ],
            "cwd": "/path/to/your/forge-mcp"
        }
    }
}

注：/path/to/your/forge-mcp は、クローンした forge-mcp ディレクトリの絶対パスに置き換えてください。

VSCode との連携

VSCode のワークスペース設定ファイル .vscode/mcp.json を更新します：

{
    "servers": {
        "forge-mcp": {
            "type": "stdio",
            "command": "pipenv",
            "args": ["run", "fastmcp", "run", "server.py"],
        }
    }
}

貢献

Forge MCP Server プロジェクトへの貢献を歓迎します！貢献するには、次の手順に従ってください：

1. リポジトリをフォークする - プロジェクトをご自身のリポジトリにフォークします
2. 機能ブランチを作成する - git checkout -b feature/your-feature-name
3. 変更をコミットする - 明確なコミットメッセージを記述してください
4. ブランチにプッシュする - git push origin feature/your-feature-name
5. プルリクエストを作成する - 加えた変更と、それを取り込むべき理由を説明してください

開発ガイドライン

• Python コードには PEP 8 のスタイルガイドラインに従ってください
• すべての関数、クラス、メソッドに docstring を記述してください
• 新機能には適切な単体テストを追加してください
• 変更内容が反映されるよう、ドキュメントを更新してください

ライセンス

Apache License 2.0