localMCP — 个人本地 MCP 服务集

本地部署的 Model Context Protocol (MCP) 服务器集合，为 AI 客户端（Codex / Claude Desktop / 其他支持 MCP 的 Agent）提供记忆、媒体生成、网页无障碍审计、Obsidian 笔记、GitHub 集成等能力。

服务清单

目录	说明	技术栈
mcp-obsidian-memory	Obsidian 笔记即记忆：SQLite + FTS5 索引、Basic Memory 风格笔记、变更审计与版本、增量索引	Node.js MCP (stdio)
mcp-agnes-media	Agnes AI 图像/视频生成：text_to_image / text_to_video / images_to_video，本地缓存去重	Python FastMCP
mcp-axe-playwright	批量网页无障碍(axe)+性能(Lighthouse)+合规检测	Node.js MCP (Playwright)
mcp-obsidian-cli	从聊天保存笔记到 Obsidian Vault（社区 MCP 封装）	Node.js MCP
github-mcp-server	GitHub 官方 MCP 服务端（二进制发行版）	Go
global-config	共享配置目录：.env 仅保留空壳注释（兼容 --env-file），无密钥/路径变量	—

目录约定

• 每个 MCP 自带 package.json / pyproject.toml 与独立 README，配置与依赖自管理，不共享环境变量文件。
• logs/、tmp/、node_modules/、data/、.browsers/、.trash/ 等均为运行时/缓存目录，不入库（见根级 .gitignore）。

配置约定

• 密钥一律通过用户环境变量提供，不入库：
  • mcp-agnes-media → AGNES_API_KEY
  • github-mcp-server → GITHUB_PERSONAL_ACCESS_TOKEN（由客户端 MCP 配置注入）
  • mcp-obsidian-memory → 通过 OBSIDIAN_MEMORY_ROOTS / OBSIDIAN_MEMORY_DB 指定根目录与索引库
• 子 MCP 允许各自的 .env（已被 .gitignore 排除），但仅作本地覆盖。

快速开始

# Obsidian 记忆 MCP
cd mcp-obsidian-memory && npm install && npm start

# Agnes 媒体 MCP（需先设置用户环境变量 AGNES_API_KEY）
cd mcp-agnes-media && pip install -e ".[dev]" && agnes-mcp

# 网页无障碍审计 MCP
cd mcp-axe-playwright && npm install && npm start

测试

cd mcp-obsidian-memory && node full-test.mjs        # 全功能走查
cd mcp-agnes-media && python -m pytest -q           # 25 用例
cd mcp-axe-playwright && npm test

安全与版本管理

• 本仓库不包含任何密钥/令牌/数据库：.gitignore 排除 .env、*.db、node_modules、.browsers、tmp、logs、.trash 等。
• 若将本仓库设为公开，请确保不向其中添加任何真实密钥或本地敏感数据。