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によって構築されました。
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