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に対応しています。ほとんどのリファレンスサーバーは単なるおもちゃであり、単一のツールしかなく、認証も可観測性もありません。このツールキットは、必要な機能がすべて揃った、意見の強い代替手段です。

コマンド一つで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を参照してください。プルリクエストを歓迎します。

ライセンス

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