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 스키마에서 직접 작동합니다. 두 가지 모드를 지원하는 하나의 도구입니다.


빠른 시작

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

두 가지 모드

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개의 평면적인 도구를 제공합니다. 업데이트, 삭제, 결제 의도 수명 주기, 체크아웃 세션, 쿠폰 기능은 없습니다.

41개 항목의 브리핑과 함께 Stripe OpenAPI 사양에 대해 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 파이프라인 또는 팀원과 연결할 수 있습니다.


프레임워크 지원 (generate 모드)

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