MidOS - MCP Community Library
Curated knowledge API for AI agents - skill packs, semantic search, validated patterns.
ماذا يمكنك أن تفعل مع MidOS - MCP Community Library؟
- 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)
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http midos-mcp-community-library 'https://midos.dev/mcp'
{
"mcpServers": {
"midos-mcp-community-library": {
"type": "http",
"url": "https://midos.dev/mcp"
}
}
}
midos-mcpclaude mcp add midos-mcp-community-library -- uvx midos-mcp==2026.2.23.1
{
"mcpServers": {
"midos-mcp-community-library": {
"command": "uvx",
"args": [
"midos-mcp==2026.2.23.1"
]
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
midos-mcp
MidOS MCP Community Library — Knowledge, Skills, and Research as MCP tools.
Install once, connect to any AI client.
Install
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/).
export MIDOS_ROOT=/path/to/midos
Quick Start
# 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
Commands
midos-mcp serve
Start the MCP server with your preferred transport.
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
| Flag | Transport | Use Case |
|---|---|---|
--stdio | stdio | Claude Code, Cursor, Cline (default) |
--http | Streamable HTTP | Web clients, remote access |
--sse | Server-Sent Events | Legacy clients |
midos-mcp config
Generate ready-to-paste JSON config for any supported MCP client.
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
Check server health: knowledge base stats, vector store status, dependencies.
midos-mcp health # Human-readable output
midos-mcp health --json # JSON output for scripts
midos-mcp keys
Manage API keys for tiered access control.
midos-mcp keys generate --name "my-app" --tier dev
midos-mcp keys list
midos-mcp keys revoke midos_sk_abc
Tiers: dev (free), pro ($10/mo), admin.
Configuration
Environment Variables
| Variable | Default | Description |
|---|---|---|
MIDOS_ROOT | auto-detect | Path to MidOS installation (required) |
MIDOS_HOST | 127.0.0.1 | HTTP server bind host |
MIDOS_PORT | 8419 | HTTP server bind port |
MIDOS_TRANSPORT | stdio | Default transport |
Root Detection
The server locates the MidOS knowledge base:
MIDOS_ROOTenvironment variable (recommended)- Auto-detect: walks up from package location looking for
CLAUDE.md+knowledge/ - Fallback: current working directory
If you installed via pip, auto-detect won't find the knowledge base. Either:
# 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
Verify with midos-mcp health — it shows the detected root and knowledge counts.
Supported Clients
| Client | Config File | Transport |
|---|---|---|
| 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 |
Optional Dependencies
# Vector store support (LanceDB + embeddings)
pip install midos-mcp[vector]
# Development tools
pip install midos-mcp[dev]
What's Inside
MidOS exposes 68 MCP tools across 2 tiers:
| Tier | Tools | Access |
|---|---|---|
| Dev | 34 tools | Free — no API key needed, full content, 500 queries/month |
| Pro | 68 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
| Tier | Queries/month | Content |
|---|---|---|
| Dev | 500 | Full content (no truncation) |
| Pro | 100,000 | Full 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
الأسئلة الشائعة
ما هو MidOS - MCP Community Library؟
Curated knowledge API for AI agents - skill packs, semantic search, validated patterns.
كيف أثبّت MidOS - MCP Community Library؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http midos-mcp-community-library 'https://midos.dev/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج MidOS - MCP Community Library إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل MidOS - MCP Community Library مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون MidOS - MCP Community Library؟
ينشره MidOSresearch. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.