Openapi X MCP

🚀 OpenAPI と MCP

OpenAPI 仕様から型安全な MCP（モデルコンテキストプロトコル）サーバーを生成します。

🚀 クイックスタート

このパッケージを使用すると、OpenAPI 仕様に基づいて型安全な MCP サーバーを生成し、実行することができます。CLI ツールを提供しており、コード生成、設定管理、サーバー実行などの操作を行うことができます。また、MCP クライアントで外部設定を使用する場合は、単一のコマンドで IDE またはクライアントに追加することができます。

✨ 主な機能

• OpenAPI 仕様から型安全な MCP サーバーを生成します。
• CLI ツールを提供し、コード生成、設定管理、サーバー実行をサポートします。
• MCP クライアントで外部設定を使用する場合、単一のコマンドで IDE またはクライアントに追加できます。

📦 インストール

npx -y -p @usemodel-dev/cli@latest

💻 使用例

基本的な使用法

1. サーバーコードの生成

OpenAPI 仕様から MCP サーバーコードを生成します。

npx -y -p @usemodel-dev/cli@latest cli generate <ABSOLUTE_PATH_TO_SPEC_YAML_OR_JSON>

これにより、cwd() ディレクトリに MCP サーバーファイルが作成されます。

npx を使用してサーバーを実行する

npx -y -p @usemodel-dev/cli@latest server

2. MCP クライアント設定の構成

MCP クライアント（Cursor、Windsurf など）に設定を追加または更新します。

npx -y -p @usemodel-dev/cli@latest cli config add <client> '<config_json>'

ここで：

• <client> は cursor、windsurf、または claude のいずれかです。
• <config_json> は設定を含む JSON 文字列です。

例：

# Cursor にサーバー設定を追加または更新する
npx -y -p @usemodel-dev/cli@latest cli config add cursor '{"@yourorg/mcp": {"url": "http://localhost:3000", "env": { "apiKey": "XXX" } } }'

設定の削除

npx -y -p @usemodel-dev/cli@latest cli config remove <client> <servername>

例：

# Cursor からサーバー設定を削除する
npx -y -p @usemodel-dev/cli@latest cli config remove cursor @yourorg/mcp

設定の保存場所

クライアントに応じて、設定は以下の場所に保存されます。

• Cursor：~/.cursor/mcp.json
• Windsurf：~/.codeium/windsurf/mcp_config.json
• Claude：~/Library/Application Support/Claude/claude_desktop_config.json

すべての設定は、設定ファイルの mcpServers キーの下に保存されます。新しい設定を追加すると、既存の設定とマージされ、既存の設定を更新すると上書きされます。

高度な使用法

ローカル開発

1. サーバーのビルド：

pnpm build

注意：ビルドする前に生成コマンドを実行する必要があります。

2. サーバーの起動：

pnpm start

これにより、http://localhost:3001 でサーバーが起動します。

環境変数

サーバーは dotenv を使用して設定を管理しています。プロジェクトのルートディレクトリに .env ファイルを作成し、必要な環境変数を追加するだけです。

🔧 技術詳細

依存関係

• @modelcontextprotocol/sdk：MCP の実装に使用されます。
• express：Web サーバーフレームワークとして使用されます。
• openapi-typescript：TypeScript 型の生成に使用されます。
• zod：ランタイム型検証に使用されます。

📄 ライセンス

MIT

パッケージ情報

現在のバージョン：0.0.1

このプロジェクトは GitHub でホストされており、https://github.com/@usemodel-dev/cli.git からアクセスできます。問題やプルリクエストの投稿を歓迎します。