MCP-Anything
원하는 것을 설명하세요. 프로덕션 환경에서 사용할 수 있는 MCP 서버를 얻으세요. 그리고 그것이 좋은지 증명하세요.
tests
Discord
License: Apache 2.0
Python 3.10+
PyPI
mcp-anything
mcp-anything https://petstore3.swagger.io/api/v3/openapi.json --install claude-code
mcp-anything grade "npx -y @modelcontextprotocol/server-memory"
MCP-Anything은 API 스펙, 코드베이스 또는 일반 언어의 간략한 설명(plain-language brief)을 완전하게 구현된 MCP 서버로 변환하며, 어떤 MCP 서버든 (자신의 것이든 다른 사람의 것이든) 에이전트가 얼마나 쉽게 사용할 수 있는지 평가합니다. Claude, GPT 또는 사용자의 기기에서 실행되는 모델과 함께 작동합니다.
<!-- demo: record docs/demo.tape, commit docs/demo.gif, then replace this comment with  -->
설치
LLM 단계는 사용자가 선택한 모델(Models 참고)을 사용합니다. 또한, --no-llm 옵션을 사용하여 LLM 없이도 모든 것이 작동합니다.
또는 Claude Code 내부에서
설치 단계가 없습니다: 이 스킬이 첫 사용 시 CLI를 자동으로 설치합니다.
/plugin marketplace add gabrielekarra/mcp-anything
/plugin install mcp-anything@mcp-anything
그런 다음 다음과 같이 요청하세요: "이 OpenAPI 스펙을 MCP 서버로 변환해 줘" 또는 "내 Flask 앱을 MCP 도구로 감싸줘".
단일 명령어로: 소스에서 서버까지
mcp-anything https://api.example.com/openapi.json
mcp-anything ./openapi.yaml --install cursor
mcp-anything ./my-flask-app --name shop
스펙 URL, 스펙 파일(OpenAPI, GraphQL, .proto) 또는 코드 폴더를 지정합니다. 이 도구는 소스(사용 가능한 경우 모델에 의해 재작성된 스펙의 제목, 설명, 태그 및 작업 목록)에서 간략한 개요(brief)를 작성하고, 서버를 구축하며, 이를 옆에 brief.yaml로 저장하여 사용자가 편집하고 다시 빌드할 수 있게 합니다:
mcp-anything build --brief mcp-petstore-api-server/brief.yaml -o mcp-petstore-api-server
클라이언트에 추가하기
mcp-anything install ./mcp-petstore-api-server --client claude-code
--client는 claude-code, claude-desktop, cursor 또는 vscode를 받습니다(여러 개 반복 가능). 이 항목은 클라이언트의 설정 파일에 병합되며, 기존 파일은 한 번 백업되고, 다시 실행해도 아무 변화가 없습니다. --url http://host/mcp는 이미 HTTP로 실행 중인 서버를 설치하며, --print는 해당 항목을 작성하는 대신 표시합니다.
모든 MCP 서버 등급 평가하기
mcp-anything grade "npx -y @modelcontextprotocol/server-filesystem ."
mcp-anything grade https://example.com/mcp
mcp-anything grade ./mcp-petstore-api-server
...
./mcp-petstore-api-server
Grade A 95/100 7 tools, about 1,025 tokens of tool list
...
이 등급은 에이전트가 실제로 볼 수 있는 서버의 도구 목록에 대한 정적 검토이며, 총 15가지 규칙을 기반으로 합니다. 모든 규칙은 결정론적입니다: 동일한 서버는 모델 개입 없이 항상 동일한 점수를 받습니다.
| Rule | 확인 항목 |
|---|
| G01, G02 | 도구의 수와 요청당 도구 목록이 소모하는 토큰 수 |
| ... | |
이는 서버가 얼마나 쉽게 선택되고 올바르게 호출될 수 있는지를 나타낼 뿐, 도구가 작동하는지 여부를 측정하지는 않습니다: mcp-anything eval이 이를 측정합니다.
배지 및 CI 체크
mcp-anything grade ./my-server --badge grade.svg --min-score 80
--badge는 SVG 배지를 작성하고, --shields는 shields.io endpoint 파일을 생성하며, --min-score는 임계값 미만일 경우 오류와 함께 종료됩니다. GitHub Actions에서:
- uses: gabrielekarra/mcp-anything@main
with:
target: python -m my_server
...
액션은 보고서를 job summary에 작성하고 score와 grade를 출력으로 노출합니다.
리더보드 (The leaderboard)
scripts/leaderboard.py는 scripts/servers.yaml에 나열된 서버(MCP 레퍼런스 서버 및 여러 공식 서버 포함)를 평가하고, 사용된 버전과 날짜가 명시된 docs/leaderboard.md 파일을 작성하여 모든 수치를 재현할 수 있게 합니다. 풀 리퀘스트로 서버를 추가하세요.
현재 리더보드 보기: 2026-11-16에 0.3.0 버전으로 평가된 10개 서버.
라이브 서버 대비 평가 (Eval against a live server)
mcp-anything eval ./my-server
mcp-anything eval ./my-server --agent --model ollama:qwen3:8b
brief로 빌드된 모든 서버는 eval_cases.json을 포함합니다. Direct 모드는 각 케이스의 도구를 입력과 함께 호출하고 출력 패턴 또는 예상 오류를 확인합니다. --agent는 각 사용 사례를 서버의 도구가 있는 모델에 제공하며, --max-steps 내에서 올바른 것을 호출할 때 통과합니다. --min-pass 0.8은 통과율이 낮으면 CI(Continuous Integration)를 실패시키고; --format json은 기계용입니다.
brief로부터 빌드 (Build from a brief)
완벽한 제어를 위해, 직접 brief를 작성할 수 있습니다:
server_name: payments-mcp
domain_description: >
...
mcp-anything build --brief my-api.yaml -o ./my-mcp-server --install claude-code
모델은 사용자의 brief를 읽고, 관련 작업을 인체공학적 도구(ergonomic tools)로 그룹화하며, 에이전트 설명을 작성하고, SKILL.md 에이전트 가이드와 평가 세트를 포함한 전체 패키지를 생성합니다.
generate: 코드베이스 스캐너 (the codebase scanner)
간략한 설명 없이 소스 코드나 스펙을 지정하면 됩니다: 정적 감지(static detection)를 사용하며 모델이 필요하지 않습니다.
mcp-anything generate /path/to/your/app
mcp-anything generate https://api.example.com/openapi.json
모델 (Models)
mcp-anything build --brief my-api.yaml --model ollama:qwen3:8b
export MCP_ANYTHING_MODEL=openai:gpt-5
--model | Provider | 필요 사항 |
|---|
anthropic:claude-opus-5-5 (기본값) 또는 모든 claude-* id | Anthropic | pip install "mcp-anything[llm]", ANTHROPIC_API_KEY |
| ... | | |
MCP_ANYTHING_BASE_URL은 Anthropic이 아닌 모든 Provider를 다른 주소로 지정하며, MCP_ANYTHING_CONTEXT는 Ollama의 컨텍스트 창을 설정합니다 (기본값 32k이므로 긴 스펙도 누락되지 않습니다). 모델을 사용할 수 없거나 응답이 좋지 않은 경우, 각 단계는 실패하는 대신 결정론적 버전(deterministic version)으로 폴백됩니다.
얻게 되는 것 (What you get)
두 모드 모두 완전하고 pip으로 설치 가능한 패키지를 생성합니다:
my-mcp-server/
├── mcp_<name>/
│ ├── server.py # FastMCP 서버 (stdio 또는 HTTP)
...
모든 매개변수는 스펙에서 설명을 가져오며, 허용 값은 열거형(enums)이 되고, 도구는 HTTP 메서드에 따라 읽기 전용(read-only) 또는 파괴적(destructive)으로 주석 처리됩니다. SKILL.md는 인간이 아닌 에이전트를 위해 작성되었습니다: 모든 도구의 매개변수, 사용 레시피, 주의 사항 및 안티 패턴을 포함합니다.
- CRUD 그룹화 (Group CRUD). 동일한 리소스에 대한 세 가지 이상의 작업은 단일
manage_X(operation=...) 도구가 됩니다. 더 적은 수의 도구로 더 넓은 범위를 커버하여 에이전트가 선택하기 쉽습니다.
- 전체 생명 주기 (Full lifecycle). 도구 설계 단계는 사용 사례를 전체 API 범위(생성, 읽기, 업데이트, 삭제, 목록 조회 및 생명 주기 전환(확인(confirm), 캡처(capture), 취소(cancel), 최종화(finalize), 무효화(void)))에 매핑합니다.
- 간결함 + 상세함 (Compact + verbose). 모든 도구에는
verbose 플래그가 있습니다. 기본적으로 필수 필드만 반환하며, verbose=true는 메타데이터와 함께 전체 API 응답을 반환합니다.
- 디스커버리 엔드포인트 (Discovery endpoint). 모든 서버는
GET /.well-known/mcp를 노출하여 모든 도구와 그 공개 수준(disclosure levels)을 나열합니다.
생성된 서버는 examples/를 참조하세요.
출력 대상 (Output targets)
| fastmcp (기본값) | mcp-use |
|---|
| 언어 | Python | TypeScript |
| ... | | |
mcp-anything build --brief my-api.yaml --target mcp-use
mcp-anything generate /path/to/app --target mcp-use
전송 방식 (Transport)
stdio (기본값): 서버가 로컬 서브프로세스로 실행됩니다.
HTTP (공유/원격 사용에 권장):
mcp-anything generate /path/to/app --transport http
HTTP를 사용하면 한 번 배포하고 모든 에이전트 세션, CI 파이프라인 또는 팀 구성원으로부터 연결할 수 있습니다.
프레임워크 지원 (생성 모드, generate mode)
8개 에코시스템에 걸친 27가지 소스 유형을 지원합니다. 정적 감지 방식이므로 LLM(대규모 언어 모델)이 필요하지 않습니다.
| 에코시스템 | 프레임워크 / 소스 |
|---|
| Python | argparse, Click, Typer, Flask, FastAPI, Django REST Framework |
| ... | |
범위 지정 (Scoping)
생성된 코드를 수정하지 않고도 어떤 기능이 노출될지 제어할 수 있습니다.
mcp-anything generate ./my-app --include "/api/v2/*" --exclude "/internal/*"
...
로드맵 (Roadmap)
로드맵은 ROADMAP.md를, 기여 방법은 CONTRIBUTING.md를 참조하세요.
스타 기록 (Star History)
<a href="https://www.star-history.com/?repos=gabrielekarra%2Fmcp-anything&type=date&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/image?repos=gabrielekarra/mcp-anything&type=date&theme=dark&legend=top-left" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/image?repos=gabrielekarra/mcp-anything&type=date&legend=top-left" />
<img alt="Star History Chart" src="https://api.star-history.com/image?repos=gabrielekarra/mcp-anything&type=date&legend=top-left" />
</picture>
</a>
더 이상 MCP 서버를 수동으로 작성하거나 그 품질을 추측하는 것을 멈추세요.