Offline Mp Cs

自托管MCP堆栈

对于恢复工作的AI代理： 从上到下阅读此文件。STATE部分告诉磁盘上存在什么。下一部分告诉你该做什么。下面的参考部分有你需要的详细信息。

这是什么

一个自托管的开发环境，用您控制的本地工具和OSS取代云MCP服务器。没有供应商锁定，没有费率限制，不依赖于其他人的正常运行时间。

Cloud MCP Server  →  Extract tool definitions  →  Generate SKILL.md
                     ("phone book")                (points to self-hosted tools)

基础路径： /Users/lucassaintlaurent/Desktop/Workspace/GitHubVault/OfflineMPCs/ GitHub账号： CYPKNFT（克隆前在此分叉的所有存储库） 原计划： JARVIS/Plans/Context7Offline.md

______________________________________________________________________

国家——现在存在什么

完成

技能状态（全部11项完成）

未完成

最近完成

______________________________________________________________________

快速开始——开始跑步

一切都已建成。以下是如何使用它。

1.激活Python环境

cd /Users/lucassaintlaurent/Desktop/Workspace/GitHubVault/OfflineMPCs
source .venv/bin/activate

2.搜索文档（本地）

# Keyword search (fast, exact matches)
./tools/index-docs search "middleware authentication" --fts

# Semantic search (meaning-based, uses vector embeddings)
./tools/index-docs search "how to handle auth in middleware" --vec

# Hybrid search (both combined — default)
./tools/index-docs search "server components" --lib next.js

# Web search (DuckDuckGo)
./tools/search web "python sqlite fts5 tutorial"

3.查询数据

# Query CSV/JSON/Parquet directly (no import needed)
./tools/db query "SELECT * FROM 'data.csv' LIMIT 10"

# Query SQLite databases
./tools/db query "SELECT * FROM issues" --db data/projects.db
./tools/db describe data/projects.db

4.项目管理

./tools/pm project list
./tools/pm issue create OfflineMPCs "Add new docs repo" --priority high
./tools/pm issue list --status open
./tools/pm stats

5.代理消息传递

./tools/msg send general "Build phase complete"
./tools/msg read general
./tools/msg search "authentication"

6.可选web UI（Docker）

cd local-software
./start.sh                    # Start everything + open browser
./start.sh outline            # Start only Outline (http://localhost:3000)
./start.sh plane              # Start only Plane (http://localhost:8080)
./start.sh stop               # Stop all services
./start.sh logs               # Tail logs
./start.sh status             # Check what's running

重建索引（添加新文档后）

source .venv/bin/activate
./tools/index-docs build --fts            # Rebuild keyword index (~16s)
./tools/index-docs build --vec --force    # Rebuild vector index (slow, one-time)
./tools/index-docs stats                  # Check index stats
./tools/index-docs libs                   # List indexed libraries

______________________________________________________________________

参考——已经做出的关键决策

1. 自托管，不严格离线 --服务可以在本地网络上运行，而不仅仅是本地主机
2. 将所有内容分叉到CYPNFT 克隆之前（GitHubVault惯例）
3. --depth 1 对于doc repos （仅供参考），软件仓库的完整克隆
4. 剧作家MCP继续直播 --浏览器状态需要一个正在运行的进程，只有技能才能记录模式
5. SKILL.md格式 定义于 JARVIS/Plans/Context7Offline.md 第三阶段
6. 电话簿索引.json 是所有工具定义的真实来源
7. CLI优先架构 --由CLI工具而非Docker服务支持的每一项技能
8. 没有Gitea --GitHub（CYPKNFT）保持原样。 git CLI+ gh CLI已经涵盖了它
9. Docker是可选的 --如果您想要可视化界面，则仅适用于web UI（大纲、平面）
10. SQLite作为通用后端 --项目管理、消息传递、索引都使用SQLite。一个依赖关系，零服务器

______________________________________________________________________

参考——目录图

OfflineMPCs/
├── mcp-phonebooks/          # 11 cloned MCP server repos (REFERENCE ONLY)
│   ├── official-servers/        # filesystem (14), git (12), memory (9), fetch (1)
│   ├── github-mcp/              # 82 tools
│   ├── playwright-mcp/          # 26 tools
│   ├── notion-mcp/              # 22 tools
│   ├── atlassian-mcp/           # 46 tools (Jira 34 + Confluence 12)
│   ├── markdownify-mcp/         # 10 tools
│   ├── docker-mcp/              # 0 tools (gateway only)
│   ├── context7-mcp/            #  2 tools
│   ├── exa-mcp/                 #  9 tools
│   ├── firecrawl-mcp/           #  8 tools
│   └── supabase-mcp/            # 32 tools
│
├── skills/                  # SKILL.md files (ALL 11 READY)
│   ├── docs-lookup/SKILL.md     # ✓ Context7 → rg over local docs (4 ops)
│   ├── file-ops/SKILL.md        # ✓ Filesystem MCP → bash, find, rg (14 ops)
│   ├── git-ops/SKILL.md         # ✓ Git MCP → git CLI + gh CLI (12 ops)
│   ├── memory/SKILL.md          # ✓ Memory MCP → local JSON/SQLite (9 ops)
│   ├── container-ops/SKILL.md   # ✓ Docker MCP → docker CLI (14 ops)
│   ├── doc-conversion/SKILL.md  # ✓ Markdownify → Pandoc, Docling (10 ops)
│   ├── browser/SKILL.md         # ✓ Playwright → MCP stays live (26 ops)
│   ├── search/SKILL.md          # ✓ Exa/Firecrawl → ddgr + SQLite FTS5 (19 ops)
│   ├── database/SKILL.md        # ✓ Supabase → DuckDB + SQLite (15 ops)
│   ├── project-management/SKILL.md # ✓ Jira/Notion → SQLite CLI (16 ops)
│   └── messaging/SKILL.md       # ✓ Slack → SQLite messaging (12 ops)
│
├── docs/                    # 50 cloned library repos (~5.4 GB) — DATA IS HERE
│   ├── python/              # cpython, flask, django, fastapi, pydantic, requests,
│   │                        # sqlalchemy, pytest, pandas, numpy, pytorch,
│   │                        # transformers, langchain, llama_index
│   ├── javascript/          # node, next.js, react, vue, svelte, express, hono,
│   │                        # zod, tailwindcss, prisma, drizzle-orm, trpc, shadcn-ui
│   ├── rust/                # rust, rust-book, tokio, serde, axum, clap
│   ├── go/                  # go, gin, fiber, gorm
│   ├── ai-ml/               # anthropic-sdk, openai-sdk, diffusers, vllm,
│   │                        # llama.cpp, ollama, docling, chromadb, qdrant
│   └── infra/               # docker-docs, kubernetes, terraform, nginx
│
├── tools/                   # ✓ CLI wrapper scripts (ALL 5 BUILT)
│   ├── index-docs               # ✓ Python: hybrid FTS5 + ChromaDB vector search (430 lines)
│   ├── search                   # ✓ Python: unified local + web search (175 lines)
│   ├── db                       # ✓ Bash: DuckDB + SQLite query wrapper (205 lines)
│   ├── pm                       # ✓ Python: project management CRUD (310 lines)
│   └── msg                      # ✓ Python: agent messaging + channels (290 lines)
│
├── data/                    # ✓ SQLite databases (CREATED)
│   ├── docs-index.db            # ✓ FTS5 search index (163,973 chunks, 50 libraries)
│   ├── chromadb/                # ✓ Vector embeddings (all-MiniLM-L6-v2)
│   ├── projects.db              # ✓ Project management data
│   └── messages.db              # ✓ Agent messaging data (5 default channels)
│
├── .venv/                   # Python virtual environment (chromadb + deps)
│
├── local-software/             # Docker Compose configs (OPTIONAL web UIs)
│   ├── start.sh                    # ✓ Launcher script (macOS/Linux) — start, stop, status, logs
│   ├── start.ps1                   # ✓ Launcher script (Windows PowerShell)
│   ├── outline/                    # ✓ Knowledge base (Notion replacement)
│   │   ├── docker-compose.yml      #   3 containers: app + PostgreSQL + Valkey
│   │   └── docker.env              #   Environment config
│   └── plane/                      # ✓ Project boards (Jira replacement)
│       ├── docker-compose.yml      #   12 containers: full stack
│       └── plane.env               #   Environment config
│
├── manifests/
│   ├── phonebook-index.json     # 273 tool definitions from 11 MCPs
│   ├── clone-manifest.json      # 50 doc repos with hashes + sizes
│   └── skill-registry.json      # 11 ready skills + test results
│
└── tests/
    ├── test-structure.sh            # Level 1: structural validation
    ├── test-dependencies.sh         # Level 2: dependency validation
    ├── test-functional.sh           # Level 3: functional validation
    └── results/                     # JSON test results with timestamps

______________________________________________________________________

参考——工具分类（共273个）

本地（67种工具）

无需设置即可工作。使用人： file-ops, git-ops, memory, doc-conversion, browser 技能。

自托管→ CLI（19个工具）

云API被本地CLI工具取代。不需要服务器。

仅限云→ CLI替换（187个工具）

使用轻量级CLI工具取代API，而不是运行云平台的自托管副本。

______________________________________________________________________

参考——安装指南

所需的CLI工具

brew install ripgrep pandoc duckdb
pip install docling chromadb

CLI包装工具（内置 tools/)

可选Docker（仅限web UI）

只有当你想要人类的视觉界面时才需要。CLI工具在没有这些的情况下工作。

______________________________________________________________________

参考——文档查找（Context7替换）

最高优先级的技能。准备就绪--完全熟练.md skills/docs-lookup/SKILL.md.

# Resolve a library
find docs/ -maxdepth 2 -type d -iname "*next.js*"

# Search its docs
rg -n -C 3 --type md "middleware" docs/javascript/next.js/docs/

# Browse its API
rg -n "^export (default |const |function |class )" docs/javascript/next.js/packages/ --type ts | head -50

6个类别的50个图书馆。没有API密钥。没有费率限制。

______________________________________________________________________

更新中

cd /Users/lucassaintlaurent/Desktop/Workspace/GitHubVault/OfflineMPCs

# Update doc repos
find docs/ -maxdepth 3 -name ".git" -type d | while read g; do
  r=$(dirname "$g"); echo "Updating $r..."; (cd "$r" && git pull --ff-only 2>/dev/null)
done

# Update MCP phone books
find mcp-phonebooks/ -maxdepth 2 -name ".git" -type d | while read g; do
  r=$(dirname "$g"); echo "Updating $r..."; (cd "$r" && git pull --ff-only 2>/dev/null)
done