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 年底从一个小众规范变成了默认的集成层。现在每个严肃的智能体都支持它。大多数参考服务器只是玩具:只有一个工具,没有身份验证,没有可观测性。这个工具包是一个自带电池的、有主见的替代方案。

通过一条命令搭建 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

stdiohttp

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