mcp-server-toolkit
mcp-server-toolkit
生产就绪的 Model Context Protocol 服务器启动器,具备身份验证、追踪和插件系统。
由 Sarma Linux 构建。
这是什么
MCP 在 2025 年底从一个小众规范变成了默认的集成层。现在每个严肃的智能体都支持它。大多数参考服务器只是玩具:只有一个工具,没有身份验证,没有可观测性。这个工具包是一个自带电池的、有主见的替代方案。
通过一条命令搭建 MCP 服务器。将工具处理程序放入插件目录。免费获得带有 PKCE 的 OAuth 2.1、结构化日志记录、OpenTelemetry 追踪、速率限制以及类型化的工具注册表。通过 stdio 为本地智能体运行,通过可流式传输的 HTTP 为远程智能体运行,代码路径相同。
Related MCP server: MCP Server Templates
架构
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": [...]}配置
环境变量 | 用途 | 默认值 |
|
|
|
|
|
|
| OTel 收集器 URL | 未设置 |
| 用于 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 构建。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
The official MCP Server for the Mux API
The official MCP Server from Mia-Platform to interact with Mia-Platform Console
Create, deploy, and operate MCP servers directly from your GitHub repositories.
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA production-ready MCP server scaffold that features built-in authentication, Docker support, and a comprehensive CI/CD release pipeline. It provides a standardized template for deploying servers with multi-transport support and configurable read-only modes.MIT
- AlicenseNot gradedqualityDmaintenanceProvides production-grade starter templates for MCP servers with permission boundaries, integration tests, and eval contracts, enabling rapid development of secure and testable MCP servers.Apache 2.0
- AlicenseAqualityDmaintenanceA production-ready foundation for building secure, observable MCP servers with built-in authentication, rate limiting, and reference tools like database-query and semantic-search.1520 npmMIT
- AlicenseNot gradedqualityDmaintenanceA production-ready MCP server template with OAuth 2.1, RBAC, and audit logging for building secure, observable tool servers.MIT