mcp-server-toolkit
mcp-server-toolkit
認証、トレーシング、プラグインシステムを備えた、本番環境対応のModel Context Protocolサーバースターター。
Sarma Linuxによって構築されました。
概要
MCPは2025年後半にニッチな仕様から標準的な統合レイヤーへと進化しました。現在、本格的なエージェントはすべてMCPに対応しています。ほとんどのリファレンスサーバーは単なるおもちゃであり、単一のツールしかなく、認証も可観測性もありません。このツールキットは、必要な機能がすべて揃った、意見の強い代替手段です。
コマンド一つで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を参照してください。プルリクエストを歓迎します。
ライセンス
MIT。
Sarma Linuxによって構築されました。
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
- AlicenseAqualityCmaintenanceA production-ready foundation for building secure, observable MCP servers with built-in authentication, rate limiting, and reference tools like database-query and semantic-search.1542 npmMIT
- AlicenseNot gradedqualityDmaintenanceA production-ready MCP server template with OAuth 2.1, RBAC, and audit logging for building secure, observable tool servers.MIT