MCP Tool Factory Ts

🚀 MCPツールファクトリ (TypeScript)

自然言語の説明、OpenAPI仕様、データベーススキーマ、GraphQLスキーマ、またはオントロジーから、本番環境で使用可能なMCP（Model Context Protocol）サーバーを生成します。

🚀 クイックスタート

インストール

# グローバルインストール
npm install -g @heshamfsalama/mcp-tool-factory

# またはnpxを使用
npx @heshamfsalama/mcp-tool-factory generate "Create tools for managing a todo list"

APIキーの設定

少なくとも1つのプロバイダーのAPIキーが必要です。

# Anthropic Claude（推奨）
export ANTHROPIC_API_KEY=your-key-here

# またはClaude Code OAuth
export CLAUDE_CODE_OAUTH_TOKEN=your-token-here

# または他のサポートされているプロバイダー
export OPENAI_API_KEY=your-key-here
export GOOGLE_API_KEY=your-key-here
export MISTRAL_API_KEY=your-key-here
export DEEPSEEK_API_KEY=your-key-here
export GROQ_API_KEY=your-key-here
export XAI_API_KEY=your-key-here
export AZURE_OPENAI_API_KEY=your-key-here
export COHERE_API_KEY=your-key-here

最初のサーバーを生成する

# 自然言語から
mcp-factory generate "Create tools for fetching weather data by city and converting temperatures"

# OpenAPI仕様から
mcp-factory from-openapi ./api-spec.yaml

# データベースから
mcp-factory from-database ./data.db

# GraphQLスキーマから
mcp-factory from-graphql ./schema.graphql

# オントロジーから
mcp-factory from-ontology ./ontology.owl --format rdf

✨ 主な機能

📦 インストール

# グローバルインストール
npm install -g @heshamfsalama/mcp-tool-factory

# またはnpxを使用
npx @heshamfsalama/mcp-tool-factory generate "Create tools for managing a todo list"

💻 使用例

自然言語生成

mcp-factory generate "Create tools for managing a todo list with priorities" \
  --name todo-server \
  --output ./servers/todo \
  --web-search \
  --logging \
  --metrics

OpenAPI仕様

# ローカルファイルから
mcp-factory from-openapi ./openapi.yaml --name my-api-server

# カスタムベースURLを指定
mcp-factory from-openapi ./spec.json --base-url https://api.example.com

データベーススキーマ

# SQLite
mcp-factory from-database ./myapp.db --tables users,posts,comments

# PostgreSQL
mcp-factory from-database "postgresql://user:pass@localhost/mydb" --type postgresql

GraphQLスキーマ

# GraphQL SDLファイルから
mcp-factory from-graphql ./schema.graphql --name my-graphql-server

# URLエンドポイントから
mcp-factory from-graphql https://api.example.com/graphql --name my-api-server

GraphQLのクエリは読み取り専用のMCPツールにマッピングされ、ミューテーションは書き込みツールにマッピングされます。GraphQLの型は自動的にZod検証スキーマに変換されます。

オントロジー

# RDF/OWL（.owl, .rdf, .ttl）から
mcp-factory from-ontology ./ontology.owl --format rdf --name knowledge-server

# JSON-LD（.jsonld）から
mcp-factory from-ontology ./schema.jsonld --format jsonld --name linked-data-server

# カスタムYAMLオントロジーから
mcp-factory from-ontology ./domain.yaml --format yaml --name domain-server

OWLクラスはMCPリソースにマッピングされ、ObjectPropertiesはツールに、DataPropertiesはツールのパラメータになります。

テストとサーバーの起動

# テストを実行
mcp-factory test ./servers/my-server

# テスト用にサーバーを起動
mcp-factory serve ./servers/my-server

📚 詳細ドキュメント

生成されたサーバーの構造

servers/my-server/
├── src/
│   └── index.ts          # ツール、リソース、プロンプトを持つMCPサーバー
├── tests/
│   └── tools.test.ts     # Vitestテスト（InMemoryTransport）
├── package.json          # 依存関係
├── tsconfig.json         # TypeScript設定
├── Dockerfile            # コンテナデプロイメント
├── README.md             # 使用ドキュメント
├── skill.md              # Claude Codeスキルファイル
├── server.json           # MCPレジストリマニフェスト
├── EXECUTION_LOG.md      # 生成トレース（オプション）
└── .github/
    └── workflows/
        └── ci.yml        # GitHub Actions CI/CD

生成されたサーバーは、テストを容易にするためのcreateServer()ファクトリ関数をエクスポートします。サーバーは、単一の/mcp POSTエンドポイントと/health GETエンドポイントを持つストリーム可能なHTTPトランスポートを使用します。テストは、vitestを使用した高速で信頼性の高いプロセス内テストのためにInMemoryTransport.createLinkedPair()を使用します。

CLIリファレンス

生成オプション

mcp-factory generate "..." \
  --output, -o <path>           # 出力ディレクトリ（デフォルト: ./servers）
  --name, -n <name>             # サーバー名
  --description, -d <desc>      # パッケージの説明
  --github-username, -g <user>  # MCPレジストリ用のGitHubユーザー名
  --version, -v <ver>           # サーバーのバージョン（デフォルト: 1.0.0）
  --provider, -p <provider>     # LLMプロバイダー（anthropic, openai, google, mistral, deepseek, groq, xai, azure, cohere, claude_code）
  --model, -m <model>           # 使用する特定のモデル
  --web-search, -w              # APIドキュメントをWebで検索する
  --auth <vars...>              # 認証用の環境変数
  --health-check                # ヘルスチェックエンドポイントを含める（デフォルト: true）
  --logging                     # 構造化ロギングを有効にする（デフォルト: true）
  --metrics                     # Prometheusメトリクスを有効にする
  --rate-limit <n>              # レート制限（1分あたりのリクエスト数）
  --retries                     # リトライロジックを有効にする（デフォルト: true）
  --budget <amount>             # 最大支出（USD）（超過した場合に中止）
  --compare-costs               # 生成前にプロバイダー間のコスト比較を表示する