【免费下载链接】MiroSharkSimulate anything, for $1 less than 10 min - Universal Swarm Intelligence Engine项目地址https://gitcode.com/gh_mirrors/mi/MiroShark点击查看免费下载MiroShark 是一个1美元、10分钟跑完一场大规模群体智能模拟的开源引擎它把模拟中产生的海量社交数据沉淀为知识图谱并自带一个 MCP 服务器Model Context Protocol模型上下文协议。本文手把手教你把这个 MCP 服务器接入 Claude Desktop只需一段 JSON 配置Claude 就能直接查询你的图谱——列出图谱、混合检索事实、浏览社区聚类、回溯报告的推理链全程不用写一行代码。一、MiroShark 的 MCP 服务器能做什么MiroShark 的核心能力之一是把文本和智能体的每次动作都写进图谱命名实体识别NER、向量化、实体消解、矛盾检测、时序边最后通过向量检索 BM25 全文 BFS 遍历三路融合加重排器返回结果见 graph-memory-pipeline 架构图。MiroShark 内置的 MCP 服务器就建在这条流水线上。它跑在stdio模式上——不用开端口、不用守护进程Claude Desktop 会按需自动拉起它并直接复用后端backend/.env里已有的 Neo4j 和 LLM 凭据零额外配置。入口文件是 mcp_server.py它对外暴露 8 个工具工具一句话说明list_graphs列出所有知识图谱及实体/边数量建议第一个用search_graph混合检索 重排支持时间旅行as_of和事实/信念过滤browse_clusters社区聚类缩放视角首次调用自动构建search_communities直接在聚类摘要上做语义搜索更快get_community展开单个聚类返回标题、摘要和成员实体list_reports查看该图谱生成过的所有报告list_report_sections列出报告各章节get_reasoning_trace回溯报告智能体某一节的完整 ReACT 决策链完整工具说明可参考官方文档 MCP.zh-CN.md。二、准备工作先跑起来 MiroSharkMCP 服务器不是独立应用它和 MiroShark 后端共享同一套环境。所以请先确保已克隆并跑通 MiroSharkgit clone https://gitcode.com/gh_mirrors/mi/MiroShark.git cd MiroShark cp .env.example .env # 填入你的 OpenRouter / OpenAI 等 API Key然后用一键启动器./miroshark启动流程详见 INSTALL.md。启动器会自动装好 Python 依赖这是 MCP 服务器能跑起来的前提。Neo4j 里至少有一个图谱在 MiroShark 界面http://localhost:3000完成一次步骤 1图谱构建并跑完模拟。空数据库会让工具返回No graphs found.。三、30秒拿到配置片段设置面板自动生成功能最省事的姿势——打开 MiroShark 界面设置 → AI 集成 · MCPSettingsPanel.vue 中的 AI Integration · MCP 区块。该面板调用GET /api/mcp/status实现在 mcp.py会展示✅mcp_server.py是否存在✅ 你的机器上 Python 解释器和脚本的绝对路径✅ 按客户端Claude Desktop / Cursor / Windsurf / Continue预渲染好的配置片段直接复制粘贴即可✅ Neo4j 健康探测连接状态、图谱数、实体数如果面板显示 Neo4j 不可达MCP 工具也会同样失败先修好数据库再往下走。四、手动配置 Claude Desktop 的完整步骤不想用面板跟着这 4 步走。第 1 步打开配置文件Claude Desktop → Settings → Developer →Edit Config。配置文件位置macOS~/Library/Application Support/Claude/claude_desktop_config.jsonWindows%APPDATA%\Claude\claude_desktop_config.jsonLinux~/.config/Claude/claude_desktop_config.json第 2 步添加 mcpServers 配置块{ mcpServers: { miroshark: { command: uv, args: [ run, --directory, /absolute/path/to/MiroShark/backend, python, mcp_server.py ] } } }⚠️ 把/absolute/path/to/MiroShark/backend替换成你本机backend目录的真实绝对路径。第 3 步重启 Claude Desktop保存后完全退出再打开 Claude Desktop。输入框旁的️ 工具图标里就会出现miroshark的 8 个工具。第 4 步可选没有uv怎么办如果你的 PATH 里没有uv改用虚拟环境里的解释器直连command: /absolute/path/to/MiroShark/backend/.venv/bin/python, args: [/absolute/path/to/MiroShark/backend/mcp_server.py]五、验证 MCP 服务器是否接入成功在 Claude Desktop 里直接提问用list_graphs工具列出我的 MiroShark 图谱。✅ 成功Claude 返回每行一个图谱附实体数和边数。 ✅ 进阶玩法试试这句提示词列出我的图谱在最大的那个上用 browse_clusters 找与 oracle 漏洞相关的内容然后展示最近一份报告的推理链。——Claude 会自动串联list_graphs → browse_clusters → list_reports → get_reasoning_trace四个工具这就是 MCP 的价值所在。如果返回No graphs found.说明 Neo4j 是空的先去界面跑一次模拟即可。六、常见问题排查Troubleshooting 速查表现象原因解决办法MCP 日志报uv: command not founduv不在客户端继承的 PATH 中换成第 4 步的解释器直连写法或全局安装uvlist_graphs返回No graphs found.Neo4j 为空在 MiroShark 界面跑一次模拟写入图谱Neo.ClientError.Security.Unauthorized.env中NEO4J_PASSWORD过期更新.env并重启已拉起过该服务器的客户端服务器启动后立刻退出缺少mcpPython 包确认uv sync或pip install -e backend/正常完成设置面板显示mcp_script: missing运行的后端目录里没有mcp_server.py重新克隆仓库确保文件存在七、不止 Claude Desktop其他客户端同样适用同一份 MCP 服务器可以接入更多工具配置形状几乎一致Cursor写入工作区.cursor/mcp.json或全局~/.cursor/mcp.json然后Cmd/CtrlShiftP → Reload Window聊天中提及 MCP 即可调用Windsurf写入~/.codeium/windsurf/mcp_config.json在 Cascade → MCP Servers 中点 RefreshContinueVS Code / JetBrains≥ 0.9.x写入~/.continue/config.json的experimental.modelContextProtocolServers数组各客户端的完整 JSON 模板都在 MCP.md 中设置面板也会自动为你渲染好。写在最后至此你的 Claude Desktop 已经长出了一双能看见 MiroShark 知识图谱的眼睛检索事实、浏览社区、追问报告推理链全部通过自然语言完成。接下来跑一场有趣的模拟然后在 Claude 里追问这个结论是怎么得出的吧 赞分享【免费下载链接】MiroSharkSimulate anything, for $1 less than 10 min - Universal Swarm Intelligence Engine项目地址https://gitcode.com/gh_mirrors/mi/MiroShark点击查看免费下载相关推荐obscura MCP 服务器完全指南把无头浏览器接入 Claude Desktop / Claude Codeobscura MCP 服务器完全指南把无头浏览器接入 Claude Desktop / Claude Code obscura 是一个面向 AI Agent网页爬虫后端MCP 服务浏览器控制构建企业级AI智能助手FastGPT如何让大模型落地业务场景构建企业级AI智能助手FastGPT如何让大模型落地业务场景 在人工智能快速发展的今天大型语言模型LLM已经成为企业数字化转型的重要工具。然而如何让这人工智能AI AgentRAG大模型工作流自动化后端前端将 NLWeb 接入 Claude DesktopMCP 协议配置、本地服务启动与故障排查实战指南将 NLWeb 接入 Claude DesktopMCP 协议配置、本地服务启动与故障排查实战指南 导读 本指南围绕 NLWeb 官方文档《Setting uAI 应用MCP 服务AI Agent后端前端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考