QuickMCP

QuickMCP

.NET を使用して、OpenAPI、Swagger、または Google Discovery の仕様から Model Context Protocol（MCP）サーバーを簡単に構築、提供できます。

はじめに

QuickMCP は、Model Context Protocol（MCP）サーバーの作成とデプロイを効率化するために設計された、強力な .NET ツールキットです。OpenAPI、Swagger、または Google Discovery の仕様からサーバーをすばやく生成できるため、定型コードを削減し、開発を加速できます。

機能

• OpenAPI／Swagger／Google Discovery の仕様から .NET MCP サーバーを生成
• AI を活用したメタデータ生成機能で Claude Desktop 拡張機能（.mcpb）を構築
• 迅速なデプロイに対応する CLI ユーティリティを備えた、高度に構成可能な .NET ライブラリ
• 複数の構成方法（構成オプションまたはメソッドチェーン）
• 包括的な認証サポート：
  • API キー、Basic、Bearer トークン、OAuth 2.0、カスタムヘッダー
  • カスタム認証の実装インターフェース
• パスフィルタリング、HTTP のカスタマイズ、エラー処理、ログ記録に対応したツールの生成
• Claude Desktop などの MCP クライアントとのシームレスな統合
• 構成ファイルのサポートと完全な async／await 対応
• 拡張機能の説明を Google Gemini で生成する、AI を活用したメタデータ生成

インストール

CLI のインストール

dotnet tool install -g QuickMCP.CLI

ライブラリのインストール

dotnet add package QuickMCP

クイックスタート

CLI の基本的な使い方

# Serve directly from OpenAPI specification
quickmcp serve --spec-url https://petstore.swagger.io/v2/swagger.json

# Build a configuration file
quickmcp build config --spec-url https://petstore.swagger.io/v2/swagger.json --output-path ./config

# Build a Claude Desktop extension (.mcpb) with AI-generated metadata
quickmcp build ce --spec-url https://api.example.com/swagger.json -m --author-name "Your Company"

# Build extension from existing config file
quickmcp build ce -c path/to/config.json -m -k YOUR_GEMINI_API_KEY

# Serve using a configuration file
quickmcp serve --config-path ./config/mcp_server_config.json

# Add authentication to your configuration
quickmcp build config --spec-url https://api.example.com/swagger.json --auth bearer

# Add a server configuration for quick access
quickmcp add server /path/to/config.json -n MyServer

# List available servers
quickmcp list server

# Serve installed server
quickmcp serve -i myServer

# Remove a stored server configuration
quickmcp delete server MyServer

ライブラリの統合例

// Create and configure a server
var serverInfoBuilder = McpServerInfoBuilder.ForOpenApi()
    .FromUrl("https://petstore.swagger.io/v2/swagger.json")
    .WithBaseUrl("https://petstore.swagger.io")
    .AddDefaultHeader("User-Agent", "QuickMCP Client")
    .AddAuthentication(new ApiKeyAuthenticator("your-api-key", "X-API-Key", "header"));

// Build server info
var serverInfo = await serverInfoBuilder.BuildAsync();

//Integrate with official MCP C# SDK
var hostBuilder = Host.CreateApplicationBuilder();

var mcpBuilder = hostBuilder.Services
    .AddMcpServer()
    .WithQuickMCP(mcpServerInfo)
    .WithStdioServerTransport();

//Run Server
await hostBuilder.Build().RunAsync();  

MCP クライアントとの統合

{
  "mcpServers": {
    "petStore": {
      "command": "quickmcp",
      "args": ["serve", "-c", "path/to/config.json"]
    }
  }
}

または、インストール済みのサーバーを使用します

{
  "mcpServers": {
    "petStore": {
      "command": "quickmcp",
      "args": ["serve", "-i", "server_id"]
    }
  }
}

ドキュメント

以下のトピックの詳細については、Wiki を参照してください。

• ライブラリ実装ガイド
• 認証オプション
• 構成方法
• CLI の使い方
• Claude Desktop 拡張機能ビルダー

コントリビューション

コントリビューションを歓迎します！プロジェクトへの貢献は、PR または Issue を送信してください。

ライセンス

QuickMCP は MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルを参照してください。