midos-mcp

MidOS MCPコミュニティライブラリ — MCPツールとしての知識、スキル、および研究。

一度インストールすれば、あらゆるAIクライアントに接続可能です。

インストール

pip install midos-mcp

要件: MidOSナレッジベースがローカルで利用可能である必要があります。MIDOS_ROOT環境変数を設定し、MidOSのインストールディレクトリ（knowledge/とmodules/を含むディレクトリ）を指定してください。

export MIDOS_ROOT=/path/to/midos

クイックスタート

# Start server (stdio — default for Claude Code, Cursor, etc.)
midos-mcp serve

# Start with HTTP transport
midos-mcp serve --http

# Generate config for your AI client
midos-mcp config --generate claude
midos-mcp config --generate cursor

# Check health
midos-mcp health

コマンド

`midos-mcp serve`

好みのトランスポートを使用してMCPサーバーを起動します。

midos-mcp serve              # stdio (default)
midos-mcp serve --http       # Streamable HTTP on 127.0.0.1:8419
midos-mcp serve --sse        # Legacy SSE transport
midos-mcp serve --http --host 0.0.0.0 --port 9000

フラグ	トランスポート	ユースケース
`--stdio`	stdio	Claude Code, Cursor, Cline (デフォルト)
`--http`	Streamable HTTP	Webクライアント, リモートアクセス
`--sse`	Server-Sent Events	レガシークライアント

`midos-mcp config`

サポートされている任意のMCPクライアント用に、そのまま貼り付け可能なJSON設定を生成します。

midos-mcp config --generate claude    # Claude Desktop / Claude Code
midos-mcp config --generate cursor    # Cursor IDE
midos-mcp config --generate cline     # Cline (VS Code)
midos-mcp config --generate windsurf  # Windsurf IDE
midos-mcp config --generate continue  # Continue.dev
midos-mcp config --generate zed       # Zed Editor
midos-mcp config --generate opencode  # OpenCode
midos-mcp config --generate http      # Generic HTTP client

# Write to file
midos-mcp config --generate claude -o mcp-config.json

`midos-mcp health`

サーバーの健全性を確認します：ナレッジベースの統計、ベクトルストアのステータス、依存関係など。

midos-mcp health          # Human-readable output
midos-mcp health --json   # JSON output for scripts

`midos-mcp keys`

階層型アクセス制御のためのAPIキーを管理します。

midos-mcp keys generate --name "my-app" --tier dev
midos-mcp keys list
midos-mcp keys revoke midos_sk_abc

階層: dev (無料), pro ($10/月), admin。

設定

環境変数

変数	デフォルト	説明
`MIDOS_ROOT`	自動検出	MidOSインストールへのパス (必須)
`MIDOS_HOST`	`127.0.0.1`	HTTPサーバーのバインドホスト
`MIDOS_PORT`	`8419`	HTTPサーバーのバインドポート
`MIDOS_TRANSPORT`	`stdio`	デフォルトのトランスポート

ルート検出

サーバーは以下の順序でMidOSナレッジベースを特定します：

MIDOS_ROOT環境変数 (推奨)
自動検出: パッケージの場所から上位ディレクトリへ遡り、CLAUDE.md + knowledge/ を探す
フォールバック: 現在の作業ディレクトリ

pip経由でインストールした場合、自動検出ではナレッジベースが見つかりません。以下のいずれかを行ってください：

# Option A: Clone the repo and point to it
git clone https://github.com/MidOSresearch/midos.git
export MIDOS_ROOT=./midos

# Option B: Point to an existing MidOS directory
export MIDOS_ROOT=/path/to/your/midos

midos-mcp health で確認してください。検出されたルートとナレッジの数が表示されます。

サポートされているクライアント

クライアント	設定ファイル	トランスポート
Claude Desktop	`claude_desktop_config.json`	stdio
Claude Code	`.mcp.json`	stdio
Cursor	`.cursor/mcp.json`	stdio
Cline	`cline_mcp_settings.json`	stdio
Windsurf	`~/.codeium/windsurf/mcp_config.json`	stdio
Continue.dev	`~/.continue/config.json`	stdio
Zed	`~/.config/zed/settings.json`	stdio
OpenCode	`opencode.json`	SSE

オプションの依存関係

# Vector store support (LanceDB + embeddings)
pip install midos-mcp[vector]

# Development tools
pip install midos-mcp[dev]

内容

MidOSは2つの階層にわたって68個のMCPツールを公開しています：

階層	ツール	アクセス
Dev	34ツール	無料 — APIキー不要、全コンテンツ、月間500クエリ
Pro	68ツール	$10/月 — セキュリティ運用, AOTC, オーケストレーション, メーカー書き込み操作

機能

知識 — 全ドメインにわたる46,000以上の厳選されたチャンクを検索 (全コンテンツ、切り捨てなし)
スキル — 16以上の技術スタックにわたる119個の再利用可能なパターン
EUREKA — ROIが測定された383個の検証済み改善案
真実 — 50個の検証済みパッチと修正
SOTA — 140個の最先端技術の収束上限
ベクトル検索 — LanceDB + Gemini埋め込み (3072次元) によるセマンティック検索

レート制限

階層	クエリ/月	コンテンツ
Dev	500	全コンテンツ (切り捨てなし)
Pro	100,000	全コンテンツ + AOTC + opsパック

無効または期限切れのAPIキーは、自動的にDev階層にフォールバックされます。

要件

Python 3.10+
FastMCP 2.x
MidOSナレッジベース (ローカル)

ライセンス

MIT

MidOS Research Protocol