Skip to main content
Glama
sarmakska

mcp-server-toolkit

by sarmakska

mcp-server-toolkit

License: MIT Python FastAPI MCP OpenTelemetry Docker Open Source

인증, 추적, 플러그인 시스템을 갖춘 프로덕션급 Model Context Protocol 서버 스타터입니다.

Sarma Linux에서 제작했습니다.


소개

MCP는 2025년 말 틈새 사양에서 기본 통합 계층으로 발전했습니다. 이제 모든 주요 에이전트가 이를 지원합니다. 대부분의 참조 서버는 단일 도구, 인증 부재, 관측성 부족 등 장난감 수준에 불과합니다. 이 툴킷은 독자적인 관점을 가진 '배터리 포함(batteries-included)' 대안입니다.

명령어 하나로 MCP 서버를 스캐폴딩하세요. 도구 핸들러를 플러그인 디렉토리에 넣기만 하면 됩니다. PKCE를 지원하는 OAuth 2.1, 구조화된 로깅, OpenTelemetry 추적, 속도 제한, 타입이 지정된 도구 레지스트리를 무료로 제공합니다. 로컬 에이전트를 위한 stdio와 원격 에이전트를 위한 스트리밍 HTTP를 동일한 코드 경로로 실행합니다.

아키텍처

graph TD
  Client[MCP Client<br/>Desktop / Cursor / IDE]
  Client -->|stdio JSON-RPC| Stdio[stdio transport]
  Client -->|streamable HTTP| HTTP[FastAPI HTTP transport]
  Stdio --> Reg[Tool Registry]
  HTTP --> Auth[OAuth 2.1 / API key]
  Auth --> Reg
  Reg --> P1[plugin: filesystem]
  Reg --> P2[plugin: postgres]
  Reg --> P3[plugin: github]
  Reg --> P4[plugin: sarmalink]
  P4 -->|api.sarmalink.ai| SLAI[SarmaLink-AI]

  classDef ext fill:#a78bfa,stroke:#a78bfa,color:#fff
  class SLAI ext

빠른 시작

git clone https://github.com/sarmakska/mcp-server-toolkit.git
cd mcp-server-toolkit
uv sync
cp .env.example .env
uv run mcp-toolkit run --transport stdio

플러그인 작성

from mcp_toolkit.registry import registry

@registry.tool("search_docs", description="Search internal docs")
async def search_docs(query: str) -> dict:
    return {"results": [...]}

구성

환경 변수

목적

기본값

MCP_TRANSPORT

stdio 또는 http

stdio

MCP_AUTH

none, api_key, oauth

none

OTEL_EXPORTER_OTLP_ENDPOINT

OTel 수집기 URL

설정 안 됨

SARMALINK_API_KEY

sarmalink 플러그인용

설정 안 됨

배포

Distroless Docker 이미지, 약 120MB. Fly.io, Render, Railway, k8s에서 실행됩니다.

docker build -t mcp-toolkit .
docker run -p 8000:8000 --env-file .env mcp-toolkit

로드맵

docs/OPEN-ISSUES.md를 참조하세요. PR은 언제나 환영합니다.

라이선스

MIT.

Sarma Linux에서 제작했습니다.

A
license - permissive license
-
quality - not tested
C
maintenance

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sarmakska/mcp-server-toolkit'

If you have feedback or need assistance with the MCP directory API, please join our Discord server