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`	可流式 HTTP	Web 客户端, 远程访问
`--sse`	服务器发送事件 (SSE)	旧版客户端

`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、编排、Maker 写入操作

功能

知识 — 搜索跨所有领域的 46K+ 精选知识块（完整内容，无截断）
技能 — 跨 16+ 技术栈的 119 个可重用模式
EUREKA — 383 个经过验证且具有可衡量投资回报率 (ROI) 的改进
真相 — 50 个经过验证的补丁和修正
SOTA — 140 个最先进的收敛上限
向量搜索 — 通过 LanceDB + Gemini 嵌入 (3072-d) 进行语义搜索

速率限制

层级	每月查询次数	内容
Dev	500	完整内容 (无截断)
Pro	100,000	完整内容 + AOTC + 运维包

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

要求

Python 3.10+
FastMCP 2.x
MidOS 知识库 (本地)

许可证

MIT

MidOS Research Protocol