Agent 与 MCP 接入
本页目录 15 个章节
精密社区提供三个独立的线上 MCP:精密文档用于搜索和读取本站资料,精密配置用于查询配船方案和导出装配,EXCT EVE-Incursions 用于查询入侵状态、历史与影响力采样。可以按需要连接一个或多个。
MCP 是什么?
MCP(Model Context Protocol)让 AI 工具发现并调用外部服务提供的功能。例如,Agent 可以调用“搜索配置”,拿到真实配置资料,再调用“导出配置”生成 EFT。
我们把服务部署在线上。使用者在自己的工具中添加远程服务地址即可,无需下载或安装精密社区的服务端程序。客户端需要支持 远程 MCP / Streamable HTTP,并启用这个服务。
当前可用的服务
| 服务 | 远程 MCP 地址 | 连接方式 | 认证 |
|---|---|---|---|
| 精密文档 | https://wiki.exct.online/mcp | Streamable HTTP | 无需 API Key,公开只读 |
| 精密配置 | https://fit.exct.online/mcp | Streamable HTTP | 无需 API Key,公开只读 |
| EXCT EVE-Incursions | https://incursions.exct.online/mcp | Streamable HTTP | 无需 API Key,公开只读 |
精密文档提供本站全部已发布文章的目录、全文和来源链接,包括新人指南、生产教程、萨沙入侵与虫洞资料。历史文章保留历史标记和提示,默认搜索不包含历史资料。
精密配置服务支持中英文关键词、舰船名称或装备类型 ID,以及用途筛选。配置的说明、分支备注、提醒、版本和替代装备都会保留。
入侵服务提供当前已观测状态、完整保留的状态变化历史、小时曲线与每次成功采集的影响力记录,以及导入的社区和怪物参考资料。返回数据带来源、UTC 时间与更新延迟标记。
如何连接?
- 打开你使用的 Agent 工具,找到工具、连接器或 MCP 设置。
- 新增一个 远程 MCP 服务,名称填写上表对应的服务名。
- 选择 Streamable HTTP,填写上表中对应的
/mcp地址。需要多个服务时,分别添加。 - 认证选择无需认证。本服务不要求 API Key。
- 保存并启用服务,然后查看客户端发现的工具列表。
不同客户端的入口和配置名称会有所不同。支持 mcpServers 和 url 配置项的客户端,可以参考:
{
"mcpServers": {
"exct-docs": {
"url": "https://wiki.exct.online/mcp"
},
"vexor": {
"url": "https://fit.exct.online/mcp"
},
"exct-incursions": {
"url": "https://incursions.exct.online/mcp"
}
}
}如果客户端需要指定传输类型,请按该客户端的要求设置为 Streamable HTTP。只有本地命令或 stdio 配置入口的客户端,需要先确认是否支持远程连接。
连接成功后能做什么?
精密文档
| 工具 | 用途 |
|---|---|
search_docs | 搜索标题和全文,返回匹配摘要、文章 ID、日期与链接 |
get_doc | 读取完整 Markdown,保留表格、提示、链接和历史标记 |
get_docs_index | 浏览文章目录和分类,可筛选分类或包含历史文章 |
get_docs_version | 核对文档数据版本、构建时间和文章数量 |
可以直接问 Agent:“查一下精密的公开虫洞访问规则,并给出原文链接”或“从精密文档里找新人运输注意事项”。先调用 search_docs,再用返回的文章 ID 调用 get_doc,依据全文回答。
搜索参数是 query、group、includeHistorical、limit、offset;其中 group 使用目录返回的分类名,limit 为 1–50,默认 10。读取全文使用 get_doc({"id":"whr"})。目录接受 group 和 includeHistorical。版本工具无需参数。
搜索和目录的 includeHistorical 默认是 false。需要查军团历史时显式设为 true;通过 ID 读取历史文章仍会返回全文,并附带历史警告。旧入团要求、补损、设施安排和活动记录不能解释为社区现在的规则或承诺。
精密配置
精密配置会提供以下五个工具:
| 工具 | 用途 |
|---|---|
search_fits | 按中英文关键词、舰船和用途搜索配置 |
get_fit | 读取分支、版本、装备、替代选项和备注 |
export_fit | 导出选定配置的 EFT 或完整文本,或者获取原始 XML |
get_fit_screenshot | 获取选定分支与版本的默认装备截图,中英文可选 |
get_data_version | 查询配置数据版本、生成时间及官方 SDE 来源 |
你可以直接向 Agent 描述需求,例如:
- “在精密配置里找一个廉价的四级魔像方案,说明有哪些注意事项。”
- “读取这个配置的所有版本,比较装备和备注的变化。”
- “把这个配置换成它提供的另一种改装件,再给我 EFT 和对应的网站链接。”
推荐的查询流程是:先搜索配置,再读取分支和版本,最后导出选定方案。这样 Agent 能依据实际存在的配置和替代选项作答。分支、版本和替代选项应使用接口返回的 ID,具体参数见配置接口文档。
需要展示图片时,调用 get_fit_screenshot,使用同一个配置、分支和版本 ID。language 可以是 zh(默认)或 en;默认同时返回 PNG 图片和链接,设置 includeImage: false 可以只取链接与信息。网站在发布时生成截图,Agent 获取的是已发布的静态图片。
截图展示默认装备选项,不包含自选替代装备。 图片对应的分支与版本、语言和来源链接都会一起返回。Agent 推荐了替代装备时,应说明它与默认截图的区别;截图接口不会生成替代装备的图片。
EXCT EVE-Incursions
| 工具 | 用途 |
|---|---|
get_active_incursions | 查询当前已观测入侵,可筛选安全区域、星域或关键词 |
get_incursion | 按 spawn ID 读取当前或归档入侵、星系分类与空间站参考资料 |
get_incursion_history | 查询状态变化历史,筛选星域、状态、spawn ID 与时间范围 |
get_influence | 获取小时采样或每次成功观测的影响力记录 |
get_communities | 查询导入的入侵社区资料 |
get_rats | 查询导入的怪物资料与原始属性 |
get_data_version | 核对数据版本、采集时间、条数、来源与更新延迟 |
先调用 get_active_incursions,再使用结果中的 spawn ID 调用 get_incursion 或 get_influence;不要把星座 ID、星系 ID 当作 spawn ID。历史查询每页最多 50 条,通过 nextOffset 翻页,完整历史也能从静态 catalog 一次读取。详细参数见入侵接口文档。
get_influence 的 resolution 可选 hourly(默认)或 observed:小时数据使用 UTC 整点桶,保留该小时首次成功采样;观测数据保留实际采集时间、状态和母舰信息。影响力 influence 为 0–1,influencePercent 为 0–100。缺采点不会补为零,源站图表的近似参考点不会混入精确记录。
回答当前状态前检查 freshness。超过 15 分钟未成功采集、或最近采集失败时,返回 stale: true,只能解释为最后已知状态。ESI 只有当前状态,停机期间发生的全部变化无法事后补齐;历史未知字段仍保留为空。社区与怪物资料来自导入的参考数据,不代表实时验证的游戏参数。
选择配置导出格式
| 格式 | 适合的用途 |
|---|---|
| EFT | 把选定的装配导入 EVE 游戏 |
| 完整配置文本 | 保存选定装配的植入体、弹药和离线状态 |
| 原始 XML | 保存整个配置,包括全部分支、版本、双语说明和替代选项 |
EFT 格式没有植入体区段,游戏导入时会忽略装备的离线状态。需要完整留存信息时,选择文本或 XML。XML 导出返回整个原始配置;选定分支、版本和装备后的导出请使用 EFT 或文本。
不使用 MCP 也可以读取资料
普通程序和具备 HTTP 读取能力的 Agent,可以直接使用公开数据与查询接口:
精密文档:
文档 HTTP API 还提供 /api/v1/index 和 /api/v1/version。搜索与目录使用与 MCP 相同的参数;查询字符串中的 includeHistorical 只能填写 true 或 false。
精密配置:
机器读取入口在精密配置的 llms.txt。槽位、数量、弹药、替代选项和 API 参数的定义,请查阅配置接口文档。
EXCT EVE-Incursions:
HTTP 与 MCP 使用相同参数、数据来源和分页约定。影响力数据通过 /api/v1/influence?spawnId=接口返回的ID&resolution=observed 查询;完整 catalog 包含全部保留的状态变化历史,不内嵌所有曲线点。数据库、原始采集日志及备份不公开。
常见问题
浏览器打开 MCP 地址返回 405
这是正常情况。浏览器打开地址通常发送 GET 请求,而该 MCP 服务通过 Streamable HTTP 的 POST 请求处理工具调用。请在支持远程 MCP 的客户端里连接。希望在浏览器里查看资料,可以打开配置接口入口或本篇文档。
配置网站能打开,但客户端没有发现工具
检查填写的地址是否完整包含 /mcp、传输方式是否为 Streamable HTTP,以及服务是否已经保存并启用。部分客户端需要重新连接或新建对话,才能使用新添加的工具。
能搜索到配置,但读取某个分支或版本失败
重新调用 get_fit,使用它返回的分支和版本 ID。网页 URL 中的数字选择参数与接口中的 ID 含义不同;接口不会把不存在的分支或版本自动替换成另一个方案。
返回 429
三个服务分别按客户端 IP 限制为每分钟 120 次 MCP / API 请求。根据响应中的 Retry-After 等待后重试;批量读取可使用完整文档、配置或入侵历史 JSON。
使用资料时注意什么?
这些配置来自社区经验。推荐方案时,应一并说明已有的操作备注和提醒,并保留原配置链接。接口提供配置资料,不计算 DPS、抗性、坦克、电容稳定性、当前价格或角色技能效果;这些指标需要结合当前游戏版本和实际技能另行模拟。
数据版本与 SDE 来源可以通过 get_data_version 核对。生成时间表示资料构建时间,不代表作者在那个时间修改过每一份配置。
文档数据版本通过 get_docs_version 核对。文章的 updated 来自原文日期,可能为空;generatedAt 是构建时间,不代表作者更新文章的时间。回答时应保留来源链接、原文提醒和历史标记。原文 Markdown 中的相对链接以返回的文章 url 为基准解析。
协议资料:MCP 官方说明。