MidOS - MCP Community Library

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 知识库：

1. MIDOS_ROOT 环境变量（推荐）
2. 自动检测：从软件包位置向上查找 CLAUDE.md 和 knowledge/
3. 回退：当前工作目录

如果你通过 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、编排、maker 写入操作

功能

• 知识 — 搜索所有领域中 46K+ 个精选内容块（完整内容，不截断）
• 技能 — 涵盖 16+ 个技术栈的 119 个可复用模式
• EUREKA — 383 项经过验证且有实测 ROI 的改进
• Truth — 50 个经过验证的补丁和修正
• SOTA — 140 个最先进水平的收敛上限
• 向量搜索 — 通过 LanceDB 和 Gemini 嵌入进行语义搜索（3072-d）

速率限制

级别	每月查询次数	内容
Dev	500	完整内容（不截断）
Pro	100,000	完整内容 + AOTC + 运维包

无效或过期的 API 密钥会静默回退到 Dev 级别。

要求

• Python 3.10+
• FastMCP 2.x
• MidOS 知识库（本地）

许可证

MIT