MidOS - MCP Community Library

io.github.MidOSresearch由 GitHub 账号 MidOSresearch 发布v2026.2.27更新于 Oct 24, 2026

Curated knowledge for AI agents — 19K chunks, 121 skills, semantic search via MCP

已验证STDIO仅桌面知识与记忆AI 与机器学习

概览

AI 生成的概览

MidOS 通过 MCP 工具把本地 MidOS 知识库、技能与研究资料库开放给 AI 助手，用于检索和查询。

可以做什么
跨领域检索精选知识片段，在启用向量存储时返回完整内容而非截断摘要。查询跨技术栈的可复用技能模式。获取经过验证的改进、已核实的补丁与更正，以及前沿参考条目。借助 LanceDB 与嵌入模型对知识库进行语义搜索。检查服务器健康状态与知识库统计，并生成客户端配置文件。
适用场景
当你已有 MidOS 安装，并希望助手在 Claude Code、Cursor、Cline 等受支持客户端中工作时调用其精选知识、技能和研究条目，就适合使用。若没有本地 MidOS 知识库可供指向，则意义不大。
运行要求
本地 Python 3.10+ 进程，从 PyPI 安装，依赖 FastMCP 2.x。需要本地 MidOS 知识库，通过 MIDOS_ROOT 环境变量指定或自动探测。可选的向量扩展会引入 LanceDB 与嵌入模型。可选的 MIDOS_API_KEY 用于认证访问；免费 Dev 层级无需密钥。
安装前请注意
Pro 层级每月收费 10 美元，解锁写入操作和额外工具包。无效或过期的 API 密钥会静默回退到免费 Dev 层级，需确认当前生效层级。免费层级每月限 500 次查询。服务器会读取本地知识库目录，MIDOS_ROOT 应只指向你愿意暴露的目录。

安装

在 SourceWeft 中

  1. 打开 控制台中的 MidOS - MCP Community Library，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

midos-mcp

MidOS MCP Community Library — Knowledge, Skills, and Research as MCP tools.

Install once, connect to any AI client.

Install

bash
pip install midos-mcp

Requirement: MidOS knowledge base must be available locally. Set the MIDOS_ROOT environment variable to point to your MidOS installation directory (the one containing knowledge/ and modules/).

bash
export MIDOS_ROOT=/path/to/midos

Quick Start

bash
# Start server (stdio — default for Claude Code, Cursor, etc.)midos-mcp serve
# Start with HTTP transportmidos-mcp serve --http
# Generate config for your AI clientmidos-mcp config --generate claudemidos-mcp config --generate cursor
# Check healthmidos-mcp health

Commands

midos-mcp serve

Start the MCP server with your preferred transport.

bash
midos-mcp serve              # stdio (default)midos-mcp serve --http       # Streamable HTTP on 127.0.0.1:8419midos-mcp serve --sse        # Legacy SSE transportmidos-mcp serve --http --host 0.0.0.0 --port 9000
FlagTransportUse Case
--stdiostdioClaude Code, Cursor, Cline (default)
--httpStreamable HTTPWeb clients, remote access
--sseServer-Sent EventsLegacy clients

midos-mcp config

Generate ready-to-paste JSON config for any supported MCP client.

bash
midos-mcp config --generate claude    # Claude Desktop / Claude Codemidos-mcp config --generate cursor    # Cursor IDEmidos-mcp config --generate cline     # Cline (VS Code)midos-mcp config --generate windsurf  # Windsurf IDEmidos-mcp config --generate continue  # Continue.devmidos-mcp config --generate zed       # Zed Editormidos-mcp config --generate opencode  # OpenCodemidos-mcp config --generate http      # Generic HTTP client
# Write to filemidos-mcp config --generate claude -o mcp-config.json

midos-mcp health

Check server health: knowledge base stats, vector store status, dependencies.

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

midos-mcp keys

Manage API keys for tiered access control.

bash
midos-mcp keys generate --name "my-app" --tier devmidos-mcp keys listmidos-mcp keys revoke midos_sk_abc

Tiers: dev (free), pro ($10/mo), admin.

Configuration

Environment Variables

VariableDefaultDescription
MIDOS_ROOTauto-detectPath to MidOS installation (required)
MIDOS_HOST127.0.0.1HTTP server bind host
MIDOS_PORT8419HTTP server bind port
MIDOS_TRANSPORTstdioDefault transport

Root Detection

The server locates the MidOS knowledge base:

  1. MIDOS_ROOT environment variable (recommended)
  2. Auto-detect: walks up from package location looking for CLAUDE.md + knowledge/
  3. Fallback: current working directory

If you installed via pip, auto-detect won't find the knowledge base. Either:

bash
# Option A: Clone the repo and point to itgit clone https://github.com/MidOSresearch/midos.gitexport MIDOS_ROOT=./midos
# Option B: Point to an existing MidOS directoryexport MIDOS_ROOT=/path/to/your/midos

Verify with midos-mcp health — it shows the detected root and knowledge counts.

Supported Clients

ClientConfig FileTransport
Claude Desktopclaude_desktop_config.jsonstdio
Claude Code.mcp.jsonstdio
Cursor.cursor/mcp.jsonstdio
Clinecline_mcp_settings.jsonstdio
Windsurf~/.codeium/windsurf/mcp_config.jsonstdio
Continue.dev~/.continue/config.jsonstdio
Zed~/.config/zed/settings.jsonstdio
OpenCodeopencode.jsonSSE

Optional Dependencies

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

What's Inside

MidOS exposes 68 MCP tools across 2 tiers:

TierToolsAccess
Dev34 toolsFree — no API key needed, full content, 500 queries/month
Pro68 tools$10/mo — security ops, AOTC, orchestration, maker write ops

Capabilities

  • Knowledge — Search 46K+ curated chunks across all domains (full content, no truncation)
  • Skills — 119 reusable patterns across 16+ technology stacks
  • EUREKA — 383 validated improvements with measured ROI
  • Truth — 50 verified patches and corrections
  • SOTA — 140 state-of-the-art convergence ceilings
  • Vector Search — Semantic search via LanceDB + Gemini embeddings (3072-d)

Rate Limits

TierQueries/monthContent
Dev500Full content (no truncation)
Pro100,000Full content + AOTC + ops packs

Invalid or expired API keys silently fall back to Dev tier.

Requirements

  • Python 3.10+
  • FastMCP 2.x
  • MidOS knowledge base (local)

License

MIT

来源：README.md，提交 4642a7d

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v2026.2.27最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分