mcp-anything
MCP-Anything
원하는 기능을 설명하세요. 프로덕션 수준의 MCP 서버를 얻을 수 있습니다.

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: fastmcp3. 빌드
mcp-anything build --brief my-api.yaml -o ./my-mcp-server4. 실행
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.tomlSKILL.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/를 참조하세요.
출력 대상
|
| |
언어 | Python | TypeScript |
SDK | FastMCP | mcp-use |
전송 | stdio / HTTP | HTTP (포트 3000) |
설치 |
|
|
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 서버를 수작업으로 만들지 마세요.
This server cannot be deployed
Maintenance
Related MCP Connectors
AI-native mock API server with MCP. Create REST/SOAP mocks from Claude, Cursor, or Windsurf.
MCP server for secureFlows: token-free URL builders and integration-linting tools for AI agents.
Build, deploy, and host full-stack web apps from any MCP client. DB, auth, storage, cron included.
Hosted MCP server for AI-driven data ops. Create apps, manage schemas, and CRUD structured data.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAutomatically 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
- AlicenseNot gradedqualityCmaintenanceTurns 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 npmMIT
- AlicenseNot gradedqualityCmaintenanceGenerates production-ready MCP servers from natural language, OpenAPI specs, database schemas, GraphQL schemas, or ontologies.54 npm1MIT
- AlicenseNot gradedqualityBmaintenanceConverts 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 npmMIT