Skip to main content
Glama

MCP-Anything

やりたいことを記述するだけで、本番環境対応のMCPサーバーが手に入ります。

Discord License: Apache 2.0 Python 3.10+ PyPI

mcp-anything

MCP-Anythingは、エージェントに何をさせたいかを記述した平易な言語のブリーフから、完全に実装されたMCPサーバーを作成します。コードベース、OpenAPI仕様書、gRPCプロトコル、GraphQLスキーマから直接生成することも可能です。2つのモードを備えた唯一のツールです。


クイックスタート

1. インストール

pip install mcp-anything
export ANTHROPIC_API_KEY=sk-...

2. ブリーフの作成 — ドメインを記述し、データソースを指定します

# my-api.yaml
server_name: payments-mcp
domain_description: >
  A payment API for managing customers, invoices, and subscriptions.
use_cases:
  - "Create a customer with email and name"
  - "Issue an invoice and send it to the customer"
  - "Create and cancel subscriptions"
  - "Issue refunds"
data_source_path: ./openapi.json   # local file or URL
data_source_kind: openapi          # openapi | graphql | grpc
auth_method: bearer_token
backend_target: fastmcp

3. ビルド

mcp-anything build --brief my-api.yaml -o ./my-mcp-server

4. 実行

cd my-mcp-server
pip install -e .
python -m mcp_payments_mcp.server

これだけです。これでMCPサーバーが実行されます。エージェントに追加しましょう:

{
  "mcpServers": {
    "payments": { "command": "python", "args": ["-m", "mcp_payments_mcp.server"] }
  }
}

Related MCP server: mcpify

2つのモード

build — ブリーフ駆動(推奨)

LLMがブリーフを読み取り、関連する操作を人間工学に基づいたツールにグループ化し、エージェントに最適化された説明文を作成します。さらに、SKILL.mdエージェントガイドや評価用ハーネスを含むサーバーパッケージ全体を生成します。

generate — コードベーススキャナー(ブリーフ不要)

ソースコードや仕様書のURLを指定するだけです。静的解析を行うため、LLMは不要です。

# From a local codebase
mcp-anything generate /path/to/your/app

# From a URL (OpenAPI, GraphQL, gRPC)
mcp-anything generate https://api.example.com/openapi.json

得られるもの

どちらのモードでも、pipでインストール可能な完全なパッケージが生成されます:

my-mcp-server/
├── mcp_<name>/
│   ├── server.py          # FastMCP server (stdio or HTTP)
│   ├── tools/             # One file per tool, HTTP calls via httpx
│   ├── discovery.py       # GET /.well-known/mcp
│   └── telemetry.py       # Anonymised per-call logging
├── SKILL.md               # Agent-readable usage guide (recipes, gotchas, anti-patterns)
├── quick_queries.json     # Eval set derived from your use cases
├── eval_cases.json        # LLM-generated evaluation cases
├── conformance_report.json
├── Dockerfile
└── pyproject.toml

SKILL.mdは最も重要な成果物です。これは人間ではなくAIエージェントのために書かれた構造化ドキュメントであり、各ツールのパラメータ、操作モード、使用レシピ、注意点、アンチパターンがリスト化されています。エージェントは呼び出しを行う前にこれを読み込むため、ハルシネーションや誤用が劇的に減少します。


ツールの設計方法

LLMは2026年のMCP設計ルールを自動的に適用します:

CRUDのグループ化。 同じリソースに対する3つ以上の操作は、単一のmanage_X(operation=...)ツールにまとめられます。ツール数が減り、カバー範囲が広がるため、エージェントが使いやすくなります。

完全なライフサイクル。 ツール設計フェーズではユースケースを読み取り、ハッピーパスだけでなくAPIの全範囲をマッピングします。作成、読み取り、更新、削除、一覧表示、およびあらゆるライフサイクル遷移(確認、キャプチャ、キャンセル、確定、無効化など)がすべて含まれます。

コンパクトかつ詳細。 すべてのツールにはverboseフラグがあります。デフォルトでは必須フィールドのみを返しますが、verbose=trueを渡すとメタデータを含む完全なAPIレスポンスを取得できます。

検出エンドポイント。 すべてのサーバーは、すべてのツールとその開示レベルをリストするGET /.well-known/mcpを公開します。


具体例:Stripe

公式Stripeエージェントツールキットは、作成と一覧表示のみをカバーする15個のフラットなツールを提供しています。更新、削除、支払いインテントのライフサイクル、チェックアウトセッション、クーポンなどは含まれていません。

Stripe OpenAPI仕様書に対して41項目のブリーフでmcp-anythingを実行した場合:

mcp-anything build --brief stripe.yaml -o ./stripe-mcp --target fastmcp

公式Stripeツールキット

mcp-anything

ツール

15個のフラットなツール

13個のグループ化されたツール

顧客

作成、一覧

作成、読み取り、更新、削除、一覧

支払いインテント

一覧のみ

作成、読み取り、一覧、確認、キャプチャ、キャンセル

請求書

作成、確定

作成、読み取り、一覧、送信、支払い、無効化

サブスクリプション

作成、キャンセル

作成、読み取り、更新、キャンセル、再開、一覧

チェックアウトセッション

✗

作成、取得、期限切れ

クーポン&プロモコード

✗

完全サポート

13個のツールでブリーフを100%カバーし、公式ツールキットにはない10以上の機能を実現しています。


具体例:GitHub

公式GitHub MCPサーバーは、手作業で構築されたGoプロジェクトです。構築には数ヶ月かかりました。

mcp-anything build --brief github.yaml -o ./github-mcp

公式(手動構築)

mcp-anything

構築時間

数ヶ月

約30秒

ツール

51個のフラットなツール

22個のグループ化されたツール

カバー範囲

キュレーションされたサブセット

対象操作の100%

言語

Go

Python

22個のツールで同じ51個の操作をカバーしており、機能を損なうことなく表面積を57%削減しています。グループ化(manage_repository、manage_issue、manage_pull_requestなど)は、エージェントが実際に好む形式です。

生成された完全な出力については、examples/github-server/を参照してください。


出力ターゲット

fastmcp (デフォルト)

mcp-use

言語

Python

TypeScript

SDK

FastMCP

mcp-use

トランスポート

stdio / HTTP

HTTP (ポート 3000)

インストール

pip install -e .

npm install && npm run dev

mcp-anything build --brief my-api.yaml --target mcp-use
mcp-anything generate /path/to/app --target mcp-use

トランスポート

stdio (デフォルト): サーバーはローカルのサブプロセスとして実行されます。

{
  "mcpServers": {
    "my-app": { "command": "mcp-my-app", "args": [] }
  }
}

HTTP (共有/リモート利用に推奨):

mcp-anything generate /path/to/app --transport http
# server runs at http://localhost:8000/sse
{
  "mcpServers": {
    "my-app": { "url": "http://localhost:8000/sse" }
  }
}

HTTPを使用すると、一度デプロイするだけで、あらゆるエージェントセッション、CIパイプライン、チームメンバーから接続できるようになります。


フレームワークサポート(生成モード)

8つのエコシステムにわたる27種類のソースタイプ。静的解析のため、LLMは不要です。

エコシステム

フレームワーク / ソース

Python

argparse, Click, Typer, Flask, FastAPI, Django REST Framework

Java / Kotlin

Spring Boot, Spring MVC, JAX-RS / Quarkus, Micronaut

JavaScript / TypeScript

Express.js

Go

Gin, Echo, Chi, gorilla/mux, Fiber, net/http

Ruby

Rails

Rust

Actix-web, Axum, Rocket, Warp

API仕様書

OpenAPI 3.x / Swagger 2.x, GraphQL SDL, gRPC / Protobuf

プロトコル / IPC

WebSocket (JSON-RPC), MQTT, ZeroMQ, XML-RPC, raw socket, D-Bus


スコーピング

生成されたコードを編集することなく、どの機能を公開するかを制御できます。

# Include / exclude by glob
mcp-anything generate ./my-app --include "/api/v2/*" --exclude "/internal/*"

# Review mode: pause after analysis, curate scope.yaml, then resume
mcp-anything generate ./my-app --review
vim mcp-my-app-server/scope.yaml
mcp-anything generate ./my-app --resume

# Reusable scope file
mcp-anything generate ./my-app --scope-file ./mcp-scope.yaml

ロードマップ

完全なロードマップについてはROADMAP.mdを参照してください。貢献についてはCONTRIBUTING.mdを参照してください。


Star History


MCPサーバーを手作業で書くのはやめましょう。

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Automatically converts any OpenAPI specification or Postman Collection into an MCP server, enabling AI assistants like Claude to directly interact with REST APIs without writing any code.
    Apache 2.0
  • A
    license
    Not graded
    quality
    C
    maintenance
    Turns any OpenAPI specification into a fully working MCP server with a single command, enabling AI agents to call APIs without writing any glue code.
    8 npm
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Converts any OpenAPI 3.x spec into a live MCP server, making every endpoint a validated tool that AI agents can call without writing glue code.
    5 npm
    MIT