自然言語のツール記述から新しいMCPサーバーを生成するメタMCPサーバーです。
プロジェクト名、短い説明、自然言語のツール記述のリスト（例: "fetches the weather for a string city and returns a string summary"）を指定すると、mcp-toolforge は完全で実行可能なMCPサーバープロジェクト（スキーマ、実装、実アサーション付きテスト、README、LICENSE）を作成し、インストールして実行できる状態にします。
flowchart TD
subgraph Client_Layer["AI Client / Claude Desktop"]
A["Client (Claude, Cursor, etc.)"]
end
subgraph Meta_Server["mcp-toolforge (this repo)"]
M["mcp_toolforge.server"]
G["mcp_toolforge.generator"]
end
subgraph Generated["Generated Server Project"]
P["src/<pkg>/__init__.py"]
S["src/<pkg>/server.py"]
T["tests/test_<pkg>.py"]
R["README.md"]
L["LICENSE"]
PP["pyproject.toml"]
end
A -- "MCP stdio JSON-RPC" --> M
M -- "generate_server tool call" --> G
G -- "writes files" --> P
G -- "writes files" --> S
G -- "writes files" --> T
G -- "writes files" --> R
G -- "writes files" --> L
G -- "writes files" --> PP┌─────────────────────┐ ┌──────────────────────────┐
│ AI Client │ stdio │ mcp-toolforge server │
│ (Claude, Cursor) │──JSON──│ (this repo) │
└─────────────────────┘ RPC └────────┬───────────────┘
│ generate_server
│ (name, description,
│ tool_descriptions, dest)
▼
┌────────────────────────────────────┐
│ generator.generate_project() │
│ parses NL → ToolSpec → ServerSpec │
│ renders: pyproject, server.py, │
│ tests, README, LICENSE │
└────────────────────────────────────┘
│
┌─────────────────┴─────────────────┐
│ Example generated servers │
│ • examples/weather_server │
│ • examples/todo_server │
│ • examples/math_server │
└────────────────────────────────────┘Related MCP server: MCP Server Generator
pip install -e ".[dev]"MCPサーバーとして（stdioトランスポート）：
{
"mcpServers": {
"mcp-toolforge": {
"command": "python",
"args": ["-m", "mcp_toolforge.server"],
"cwd": "/path/to/mcp-toolforge"
}
}
}または、スタンドアロンのサーバープロジェクトを生成するCLIとして：
# Interactive wizard
mcp-toolforge -i
# One-shot
mcp-toolforge \
--name my_server \
--description "A server that does X" \
--tool "fetches the weather for a string city and returns a string summary" \
--dest ./my_servergenerate_server ツールの使用mcp-toolforge がMCPサーバーとして登録されている場合、AIエージェントは以下を呼び出すことができます：
generate_server(
name="my_server",
description="A server that does X",
tool_descriptions=[
"fetches the weather for a string city and returns a string summary",
"adds a string task and returns a string confirmation"
],
dest="/path/to/output" # optional, defaults to /tmp/mcp-toolforge-gen
)このツールは完全なプロジェクトを dest/<package_name>/ に書き込み、要約文字列を返します。生成されたサーバーは、その後、MCPクライアントに個別にインストールおよび登録できます。
各ツール記述は次のパターンに従う必要があります：
<VERB> [a/an] <type> <name> [, <type> <name>] ... and returns <type> <description>例：
説明 | ツール名 | パラメーター |
|
|
|
|
|
|
|
|
|
|
|
|
認識されるパラメーター型： string、integer、number、boolean、array。型指定のパラメーターが検出されない場合は、自由形式の query: string パラメーターが推測されます。
examples/ には3つのサンプルサーバーが生成されます：
サーバー | パッケージ | ツール | 説明 |
WeatherServer |
|
| 天気情報を取得します |
TodoServer |
|
| TODOリストを管理します |
MathServer |
|
| 算術ツール |
各サンプルは、独自のテスト付きの完全に動作するMCPサーバーです：
cd examples/math_server
pip install -e .
pytest# Install with dev dependencies
pip install -e ".[dev]"
# Run all tests
pytest
# Run end-to-end test against the meta-server over stdio
python e2e_test.py
# Regenerate examples
python make_examples.pytests/test_generator.py — ジェネレーターの16テスト（パース、スキーマ推論、ファイルレンダリング、プロジェクト作成）
tests/test_server.py — メタMCPサーバーの5テスト（ツール一覧、ツール呼び出し、エラー処理）
e2e_test.py — メタサーバーを実際のstdioサブプロセスとして実行し、MCPの Client に接続するエンドツーエンドテスト
各サンプルサーバーには4つのテストが同梱されています（3つのサンプルで合計12テスト）
すべてのテストは実際のアサーションを使用し、実際のファイル出力/ツール結果を検証します。
MIT — LICENSE を参照してください。
This server cannot be deployed
MCP server for generating rough-draft project plans from natural-language prompts.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Create guides as MCP servers to instruct coding agents to use your software (library, API, etc).
