Openapi MCP Converter

🚀 OpenAPI 到 MCP サーバー変換器

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

✨ 主な機能

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

🚀 クイックスタート

前提条件

• 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 Server 运行在 stdio");
}

runServer().catch((error) => {
  console.error("主程序中的致命错误:", error);
  process.exit(1);
});

実行例

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

📚 ドキュメント

プロジェクト構造

/openapi-to-mcp
├── dist/        # コンパイル出力ディレクトリ
├── src/         # ソースコードディレクトリ
│   ├── example/ # サンプル設定ファイル
│   └── index.ts # コア実装ファイル
├── package.json
└── tsconfig.json

ビルドコマンド

npm run build    # 本番環境用のビルド
npm run watch    # 開発モードでのリアルタイム監視ビルド

📄 ライセンス

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