smplkit MCPサーバー
コミット 2026年11月13日smplkitプラットフォーム全体のフィーチャーフラグ、設定、ログレベル、監査ログ、およびスケジュール済みジョブをAIエージェントが管理できるようにします。
別名 smplkit/mcp, mcp
- スター
- 0
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.10.6
- 最終コミット
- 2026年11月13日
- ライセンス
- MIT
smplkit MCPとは
smplkitはMCPサーバーです。 smplkitプラットフォーム全体のフィーチャーフラグ、設定、ログレベル、監査ログ、およびスケジュール済みジョブをAIエージェントが管理できるようにします。.
プロジェクトのREADMEから生成された概要
smplkit MCP server について
このサーバーは、AIチャットインターフェースからフィーチャーフラグ、設定、スケジュール済みジョブを直接管理することを可能にします。Claude Code、Claude Desktop、Cursorなどのエージェントがsmplkitプラットフォーム全体を操作するためのゲートウェイとして機能します。ホストされたエンドポイントに接続することで、AIは実行時のログレベルの調整、監査ログの検索、SIEM転送の設定など、複雑な運用タスクを、異なる管理コンソールを切り替えることなく実行できます。
サーバーは、smplkit製品のAPIに接続するステートレスなHTTPクライアントとして機能します。ユーザーは、GoogleまたはMicrosoft OAuthを使用した一度限りのブラウザサインイン、またはCIやスクリプトなどのヘッドレス環境向けの静的なAPIキーのいずれかで認証できます。フラグ、型定義された設定、ログレベル、監査イベント、およびスケジュールされたHTTPジョブを管理するための専用ツールを提供します。ステートレスであるため、認証情報はローカルに保存されず、リクエストごとに認証が検証されることが保証されます。
できること
- 1特定のユーザー向けのフィーチャーフラグの切り替えAIエージェントが、本番環境のエンタープライズ顧客に対して新しい機能を有効化できます。
- 2実行時のログレベルの調整本番環境での問題をデバッグするために、エージェントに特定のロガーの出力詳細度を上げるよう指示できます。
- 3スケジュールされたHTTPリクエストの自動化開発者は、特定の時間に特定のエンドポイントへリクエストを送信する、定期的なジョブまたは単発のジョブを設定できます。
- 4監査ログストリーミングの管理エージェントが、監査イベントをDatadogなどの外部送信先に送るようプラットフォームを設定できます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
smplkit MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude Codeにsmplkit MCPをインストール
$ claude mcp add --transport http mcp https://mcp.smplkit.com/api/mcpCursorにsmplkit MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.smplkit.com/api/mcp"
}
}
}VS Codeにsmplkit MCPをインストール
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.smplkit.com/api/mcp"
}
}
}VS Code CLIにsmplkit MCPをインストール
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.smplkit.com/api/mcp"}'Codexにsmplkit MCPをインストール
$ codex mcp add mcp --url https://mcp.smplkit.com/api/mcpCodex config.tomlにsmplkit MCPをインストール
~/.codex/config.toml
[mcp_servers.mcp] url = "https://mcp.smplkit.com/api/mcp"
Gemini CLIにsmplkit MCPをインストール
$ gemini mcp add -s user --transport http mcp https://mcp.smplkit.com/api/mcpGemini settings.jsonにsmplkit MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.smplkit.com/api/mcp",
"type": "http"
}
}
}自動チェック
実行日 2026年11月15日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能smplkit/mcp is public and reachablegithub.com/smplkit/mcp ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-06github.com/smplkit/mcp ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答Endpoint did not answer initialize: HTTP 530検出事項
README
GitHubで見るsmplkit MCP Server
A hosted, agent-native Model Context Protocol server — the gateway that lets an AI agent (Claude Code, Claude Desktop, Cursor, …) operate the whole smplkit platform on your behalf, without you ever leaving the chat.
One server, the whole platform:
- Flags — feature flags with per-environment values and targeting.
- Config — keyed, typed config with per-environment overrides.
- Logging — change runtime log levels per environment.
- Audit — search the audit log and wire SIEM forwarders.
- Jobs — scheduled HTTP jobs (cron, one-off, or on-demand) with response capture.
Once connected, tell your agent "turn on the new checkout for enterprise users in prod," "set the staging database host," "raise the SQL logger to DEBUG in prod," "stream audit events to Datadog," or "POST my endpoint every morning at 7." It makes the change, proves it works, and answers follow-up questions straight from the live state.
It is a thin, stateless HTTP client to the smplkit product APIs — it holds no credential of its own.
Connect once
1. Add the server and sign in
The server lives at https://mcp.smplkit.com/api/mcp. Point your MCP client
at that URL — the first time it connects, the client opens your browser for a
one-time sign-in (Continue with Google or Microsoft, standard OAuth).
After that it reconnects and refreshes access on its own; there's no key to mint,
copy, or rotate.
Claude Code (CLI):
claude mcp add --transport http smplkit https://mcp.smplkit.com/api/mcp
…or in .mcp.json:
{
"mcpServers": {
"smplkit": {
"type": "http",
"url": "https://mcp.smplkit.com/api/mcp"
}
}
}
Cursor (~/.cursor/mcp.json or project .cursor/mcp.json):
{
"mcpServers": {
"smplkit": {
"url": "https://mcp.smplkit.com/api/mcp"
}
}
}
Claude Desktop (claude_desktop_config.json) — Desktop bridges remote
servers through mcp-remote, which opens a browser for the one-time sign-in and
caches the connection:
{
"mcpServers": {
"smplkit": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.smplkit.com/api/mcp"]
}
}
}
Prefer a static key?
For non-interactive use — CI, scripts, headless clients, or writing code with the
smplkit SDKs — skip the browser
and authenticate with an API key as a bearer token. Sign up at
https://smplkit.com (Google or Microsoft SSO, email-verified instantly),
create an API key in the console, and send it as
Authorization: Bearer YOUR_SMPLKIT_API_KEY (a custom X-Smplkit-Api-Key header
is also accepted). The SDKs read the same key from SMPLKIT_API_KEY. For example,
add a headers block to the config above:
{
"mcpServers": {
"smplkit": {
"type": "http",
"url": "https://mcp.smplkit.com/api/mcp",
"headers": { "Authorization": "Bearer ${SMPLKIT_API_KEY}" }
}
}
}
2. Ask your agent
"Create a boolean flag
new-checkout, off by default, then turn it on in prod only for enterprise users."
"List my environments, then set
database.hosttodb-staging.internalfor staging."
"Raise the
sqlalchemy.enginelogger to DEBUG in production while I debug, then reset it."
"Test whether
https://http-intake.logs.datadoghq.com/...accepts a sample, then create a Datadog forwarder for our audit events."
"POST
https://api.example.com/cache/warmevery morning at 7am NY time, then run it now to prove it works."
Tools
All tools share intent-named verbs — list_*, get_*, create_*, set_*,
delete_* — and hide the JSON:API envelopes, per-environment nesting, and
full-replace PUTs behind partial-intent calls.
| Capability | Tools |
|---|---|
| Flags | create_flag, list_flags, get_flag, set_flag, delete_flag |
| Config | create_config, list_configs, get_config, set_config_value, delete_config |
| Logging | set_log_level, list_loggers, get_logger, reset_logger |
| Audit | query_events, get_event, list_forwarders, create_forwarder, test_forwarder, delete_forwarder |
| Jobs | create_job, list_jobs, get_job, update_job, delete_job, run_job, list_runs, get_run |
| Platform | list_environments |
A few load-bearing behaviors:
set_flag/set_config_value/set_log_levelare read-modify-write. You express a partial change in one environment and the tool preserves the rest.list_environmentstells you the valid environment targets (production,staging, …) for everyset_*tool and for jobs.- Prove before you trust.
run_jobfires a job once and returns the captured response;test_forwarderdry-runs a SIEM destination before you save it. create_jobinfers the kind: a cronschedule→ recurring, arun_atdatetime → one-off, neither → manual. You never set a kind.
The bundled SKILL.md teaches an agent the whole surface.
The public-internet constraint
smplkit calls job targets and forwarder destinations from the cloud, so
those URLs must be reachable from the public internet — localhost/private
addresses won't fire. To target a local server, point at its deployed URL or
expose it with a tunnel (cloudflared tunnel --url http://localhost:PORT or
ngrok http PORT) and set a secret auth header.
Development
python3.13 -m venv .venv && . .venv/bin/activate
pip install -r requirements-test.txt
pytest # unit tests (acceptance deselected)
ruff check src tests
Run the server locally:
PYTHONPATH=src uvicorn smplkit_mcp.app:app --host 0.0.0.0 --port 8000
# MCP endpoint: http://localhost:8000/api/mcp
# Health check: http://localhost:8000/health
Configuration (env vars) — each product's base host is independently
configurable, mirroring the SDK's base_domain pattern:
JOBS_BASE_DOMAIN/FLAGS_BASE_DOMAIN/CONFIG_BASE_DOMAIN/LOGGING_BASE_DOMAIN/AUDIT_BASE_DOMAIN/APP_BASE_DOMAIN— the host for each product API (defaults<product>.smplkit.com;APP_*backslist_environments).*_SCHEME—https(default) orhttp.*_BASE_URL— full base-URL override (e.g.http://localhost:8002); wins over the two above. Used for the local platform and tests.
Acceptance tests
tests/test_acceptance.py provisions an ephemeral verified account and drives
the full tool surface against the real product APIs end-to-end — create/set/get/
delete a flag, set and read a config value, set and list a log level, query
events, create/test/delete a forwarder, list environments, and the eight Jobs
tools — then cleans up. These tests require smplkit-internal admin
credentials, so they self-skip unless an admin key is available (ADMIN_API_KEY
env or the [admin] profile in ~/.smplkit) — external contributors can ignore
them; the unit suite needs no credentials. Run them explicitly:
pytest -m acceptance
# point at a non-prod platform with <PRODUCT>_BASE_URL=...
Architecture
- Stateless Python service built on FastMCP: it holds no database and no platform credential of its own.
- Auth is per request — whether the caller signs in with OAuth or sends an API key, the credential is validated and used per request to reach each product API, and is never cached or logged.
- One thin JSON:API HTTP client per product (flags, config, logging, audit, environments), each pointed at its own configurable base host.
- The MCP endpoint is served under
/api/mcpwith a stateless, JSON-response transport (no long-lived SSE), so it behaves correctly through proxies and load balancers with short idle timeouts.
License
MIT.
smplkit MCPのよくある質問
smplkit MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --transport http mcp https://mcp.smplkit.com/api/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
smplkit MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
CI/CDやヘッドレス環境で使用できますか?
はい、設定内でAPIキーをベアラートークンとして使用することで、ブラウザベースのサインインをスキップできます。
サーバーは認証情報を保存しますか?
いいえ、このサーバーはステートレスなHTTPクライアントであり、独自の認証情報は保持せず、リクエストごとに検証を行います。
ローカルネットワーク上のジョブを実行できますか?
いいえ、ジョブのターゲットや転送先はパブリックインターネットからアクセス可能である必要があります。ローカルアドレスを使用する場合は、ngrokやcloudflaredなどのトンネルを使用してください。