Openapi To MCP Converter

🚀 OpenAPI から MCP サーバー変換ツール

このツールは、OpenAPI 仕様を自動的に Model Context Protocol (MCP) サーバーインスタンスに変換するためのものです。

🚀 クイックスタート

前提条件

• Node.js 18+
• TypeScript 5.x

基本的な使用法

パッケージをインストールします:

npm install openapi-mcp-converter

ローカルの標準入出力 (stdio) MCP サーバーを起動します:

import fs from 'fs';
import { OpenApiMCPSeverConverter } from '../index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import path from 'path';
import { fileURLToPath } from 'url';

const openApiDoc = JSON.parse(fs.readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), 'openapi.json'), 'utf8'));

const converter = new OpenApiMCPSeverConverter(openApiDoc, { timeout: 100000 });
const server = converter.getServer();
console.log(JSON.stringify(converter.getMcpTools(), null, 2));
console.log(JSON.stringify(converter.getTools(), null, 2));
async function runServer() {
  const transport = new StdioServerTransport();
  await server.connect(transport);
  console.log("GitHub MCP サーバーが標準入出力で起動しました");
}

runServer().catch((error) => {
  console.error("メインプログラムで致命的なエラーが発生しました:", error);
  process.exit(1);
});

実行例

npm run test  # サンプルのテストケースを実行

✨ 主な機能

• 🚀 自動変換: OpenAPI 3.0 仕様を自動的に解析します。
• 🛠 型安全: TypeScript に基づく強力な型検証を提供します。
• 🔄 リクエスト代理: 自動的にツール呼び出しのパラメーターマッピングを処理します。

📚 ドキュメント

プロジェクト構造

/openapi-to-mcp
├── dist/            # コンパイル出力
├── src/             # ソースコード
│   ├── example/     # サンプル設定
│   └── index.ts     # 核心実装
├── package.json
└── tsconfig.json

ビルドコマンド

npm run build    # 本番用ビルド
npm run watch    # 開発モードで監視

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は こちら を参照してください。