MisakaNet MCP Server

社区

面向 AI 编程代理的 Git 驱动故障记忆层。

分类: 开发工具第 227 / 438
Stars: ★ 529 非常热门
传输方式: stdio（本地进程）
运行环境: Python 3.10+ · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 3 天前

52FMRS · D

来源将 MisakaNet 定位为面向 AI 编程代理的故障恢复知识层，而非通用记忆、运行时或向量数据库。证据明确支持 stdio 本地运行方式和带 Bearer token 的远程配置示例，但未提供具体 MCP 工具名称，因此工具列表留空。

最强项 · 文档质量 13/20 最弱项 · 可靠性 6/20

可靠性

6/20

安全与权限

9/20

维护活跃度

13/20

文档质量

13/20

安装易用性

11/20

查看各项评分依据

可靠性 6/20: 清单明确声明使用 Python stdio 启动 scripts/mcp_server.py，但未提供工具列表、参数、初始化握手实现或已提交测试证据；README 同时声称 v2.17.0，而清单和 PyPI 包版本为 2.15.0，存在版本不一致。因此启动路径看似合理，但 MCP 行为、错误处理和关键路径无法静态验证，扣分明显。
安全与权限 9/20: 证据显示支持 Bearer token 的远程 MCP，并说明本地 MCP 不依赖服务器；README 也提醒社区课程可能包含危险命令并建议沙箱执行，且声称存在路径遍历修复、XSS 转义和邮箱脱敏。但这些安全实现无法从提供的源文件核验，未说明权限范围、数据流、远程网络行为或危险操作确认机制，因此只能给中低分；未发现足以触发红线的明确凭据窃取或默认破坏行为。
维护活跃度 13/20: 仓库未归档，声明有 Apache-2.0 许可证、CI 徽章、多个版本发布和安全响应相关文档入口，且 README 描述持续路线图与贡献流程。这些主要来自 README，缺少实际提交历史、发布记录、依赖更新和维护者响应证据；版本号还相互矛盾，因此未接近满分。
文档质量 13/20: README 覆盖用途、非目标、CLI/MCP 命令、远程配置、贡献方式、限制和安全提醒，并提供多个文档入口与示例。可是未给出实际 MCP 工具定义、完整参数/返回值、认证生命周期、权限边界、成本说明或可复核的故障处理证据；版本与安装包名称也有不一致。
安装易用性 11/20: 提供 Python 3.10+、stdio 启动命令、远程 MCP URL 和客户端 JSON 配置，整体路径较清楚；但 manifest 的 PyPI 标识与 README 链接的 misakanet-core 不一致，远程配对/token 流程依赖外部站点，且没有主流客户端兼容性、安装验证或实际测试证据，因此设置可行性只能评为中等。

静态评测 · 未实际运行收录于 2026-08-14

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要在任务执行期间检索已知故障修复方案的 AI 编程代理
希望使用 Git 和 Markdown 管理公开调试知识的开发者
偏好零依赖、无数据库部署的用户

不适合谁

通用长期记忆系统
AI 代理运行时或框架
向量数据库或 RAG 系统
技能市场

所需权限

本地 stdio 配置需要运行 Python 3 命令并访问 MisakaNet 源码及 lesson 文件
远程 MCP 配置需要使用提供的 Bearer token 访问远程端点
贡献或 intake 失败报告需要主动提交内容

风险与副作用

lesson 来自社区贡献，执行其中命令前必须审查并隔离运行
检索结果可能包含不适用于当前环境的修复建议
远程方式涉及向服务端发送搜索请求和使用访问 token

安装接入

准备工作

运行环境：Python 3.10+ · 远程托管（无需本地环境）

远程方式：访问 https://misakanet.org/connect 生成代码，并将提供的 MCP 配置加入客户端。配置使用 https://misakanet.org/mcp 和 Bearer token。源码中的本地 MCP 运行命令为 python3 scripts/mcp_server.py。

.cursor/mcp.json

{"mcpServers":{"misakanet":{"url":"https://misakanet.org/mcp","headers":{"Authorization":"Bearer YOUR_TOKEN"}}}}

以 Cursor 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "misakanet": {
      "url": "https://misakanet.org/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add --transport http misakanet https://misakanet.org/mcp --header 'Authorization: Bearer YOUR_TOKEN'

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 配置中添加 https://misakanet.org/mcp（Bearer token 来自 https://misakanet.org/connect 生成的配对码），然后在客户端输入 "Search MisakaNet for database locked"，如能返回修复路径的检索结果即说明连接成功。

常见排障

确认 Python 3 可用，并从正确的 MisakaNet 目录运行 python3 scripts/mcp_server.py
远程配置时确认端点为 https://misakanet.org/mcp 且 Bearer token 有效
先搜索具体错误文本或关键词，并核对 lesson 中的验证步骤
检查客户端是否支持并正确加载 MCP 配置

试试这样问

连接成功后，可以直接对 AI 助手这样说：

Search MisakaNet for database locked
Search MisakaNet for pip install timeout
Search MisakaNet for GitHub 401 token expired
Search MisakaNet for DCO sign-off failure

使用场景

搜索 DCO、pip 超时、GitHub 401、MCP 配置和编码问题的故障恢复经验

在 CI 失败或重复故障时查找已有修复路径

为 AI 代理提供可共享、可审计的调试经验

支持客户端

Cursor部分支持

Claude Code部分支持

Codex部分支持

依据项目文档列出，未经本站实测。

详细介绍

MisakaNet 是一个零依赖、基于 Git 的故障恢复知识库，为 AI 编程代理搜索经过记录的调试经验并提供修复路径。它使用 Python 标准库和 BM25 关键词检索，可通过 MCP、CLI 或 intake 使用。