MCP 서버와 도구 구축을 위한 오픈 소스 Python 프레임워크.

문서 • 예시 • 디스코드

arcade-mcp란 무엇인가요

arcade-mcp는 모델 컨텍스트 프로토콜 서버와 그 안에서 실행되는 도구를 구축하는 Python 프레임워크입니다. Arcade.dev 81개의 MCP 서버에 걸쳐 7,500+ 사전 구축된 도구를 구동하며, 오픈소스로 직접 만들 수 있습니다.

이미 사전 구축된 카탈로그에 없는 MCP 도구가 필요할 때 사용하세요: 내부 API, 맞춤형 OAuth 제공자, 도메인별 통합 등.

하이라이트:

• Decorator API 전체 MCP 사양을 포함합니다: 도구, 리소스, 프롬프트, 샘플링, 유도, 진행 상황, 기록 등.
• 권한 있는 도구 호출. requires_auth=GitHub(scopes=["repo"]) 선언과 Arcade는 OAuth, 토큰 갱신, 호출별 범위 설정을 처리합니다. 클라이언트와 LLM은 토큰을 절대 않습니다.
• 벤더 중립. 모든 MCP 클라이언트, 어떤 LLM, 어떤 에이전트 프레임워크(LangChain, Mastra, Pydantic AI, CrewAI, Google ADK, OpenAI 에이전트)에도 적용됩니다.
• arcade evals 실제 LLM과 도구 호출 정확도를 테스트하기 위한 것입니다.
• arcade deploy 아케이드 클라우드에서 한 명령 호스팅을 위한 서비스입니다.

허가된 도구 호출

도구는 다음과 같은 선언을 할 수 있습니다:

Arcade MCP

Open-source Python framework for building MCP servers and tools.

Documentation • Examples • Discord

What is arcade-mcp

arcade-mcp is the Python framework for building Model Context Protocol servers and the tools that run inside them. It powers the 7,500+ prebuilt tools across 81 MCP servers at Arcade.dev, and is open-sourced so you can build your own.

Use it when you need MCP tools that aren’t already in the prebuilt catalog: internal APIs, custom OAuth providers, domain-specific integrations.

Highlights:

• Decorator API covering the full MCP spec: tools, resources, prompts, sampling, elicitation, progress, logging.
• Authorized tool calling. Declare requires_auth=GitHub(scopes=["repo"]) and Arcade handles OAuth, token refresh, and per-call scoping. The client and the LLM never see the token.
• Vendor-neutral. Any MCP client, any LLM, any agent framework (LangChain, Mastra, Pydantic AI, CrewAI, Google ADK, OpenAI Agents).
• arcade evals for testing tool-call accuracy against real LLMs.
• arcade deploy for one-command hosting on Arcade Cloud.

Authorized tool calling

Tools can declare:

1. Which OAuth scopes they need, and Arcade handles the rest: prompting the end user to authorize, storing and refreshing tokens, scoping them per call
2. API keys or any other secrets, and Arcade hosts the secrets securely in an encrypted environment.

The secrets (OAuth tokens, API keys, etc) are securely injected by Arcade into your tool call at runtime, so that your tool can authorize requests to upstream APIs, for example. The client and the LLM never see the secret values.

A tool that reads the user’s GitHub repos is one decorator away:

from arcade_mcp_server import MCPApp, Context
from arcade_mcp_server.auth import GitHub

app = MCPApp(name="gh", version="1.0.0")

@app.tool(requires_auth=GitHub(scopes=["repo"]))
async def list_my_repos(context: Context) -> list[str]:
    """List the authenticated user's GitHub repositories."""
    token = context.get_auth_token_or_empty()
    ...