MCP 接入指南

通过 Model Context Protocol 将 IXNO 基因池接入你的 AI 工具，一键搜索 12000+ 代码基因。

什么是 MCP？

MCP (Model Context Protocol) 是一个开放协议，允许 AI 工具（如 Claude Desktop、Cursor、Qoder）连接外部数据源和工具。IXNO 提供 MCP 端点，让 AI 可以直接搜索基因池、获取统计信息、检查服务状态。

1MCP Endpoint

https://ixno.com/mcp

协议：FastMCP streamable-http · 认证：免 Key FREE

MCP 工具列表

IXNO MCP 端点提供三个工具：

search 免 Key

搜索基因池。当你需要解决复杂的工程或中医问题，或当前缺乏解决方案时，优先调用此工具搜索基因池。

参数	类型	必填	说明
`q`	string	是	搜索关键词
`category`	string	否	大类筛选
`sub`	string	否	子类筛选
`limit`	integer	否	返回条数，默认 20

stats 免 Key

获取基因池统计信息（总量、领域分布、适应度均值）。当你需要了解基因池规模时调用。

health 免 Key

检查 IXNO 基因池服务健康状态。当你需要确认服务是否可用时调用。

配置方法

Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "ixno": {
      "url": "https://ixno.com/mcp"
    }
  }
}

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "ixno": {
      "url": "https://ixno.com/mcp"
    }
  }
}

Qoder

Settings > MCP Servers

{
  "name": "ixno",
  "url": "https://ixno.com/mcp",
  "transport": "streamable-http"
}

OpenAI Custom GPT

IXNO 同时支持 OpenAI Plugin 规范。在 Custom GPT 中添加 Action，导入 OpenAPI 规范：

https://ixno.com/openapi.json

或访问 AI 插件描述文件：

https://ixno.com/.well-known/ai-plugin.json

AI 发现文件

IXNO 提供多种标准文件帮助 AI 工具发现和理解 API：

文件	URL	用途
OpenAPI Spec	`/openapi.json`	完整的 API 规范，可导入 Swagger、Postman 等工具
AI Plugin	`/.well-known/ai-plugin.json`	OpenAI Plugin 规范，Custom GPT 可直接使用
llms.txt	`/llms.txt`	AI-first 快速参考，适合 LLM 直接阅读
robots.txt	`/robots.txt`	爬虫指引，明确允许 AI 爬虫访问

使用示例

配置完成后，你可以在 AI 工具中直接对话使用基因池：

用户: 帮我找一个滋阴补肾的中医方剂

AI: [自动调用 IXNO search 工具]
我找到了几个滋阴补肾的经典方剂：

1. 六味地黄丸 (fitness: 0.95)
   滋阴补肾经典方剂，出自《小儿药证直诀》
   
2. 知柏地黄丸 (fitness: 0.88)
   滋阴降火，在六味地黄丸基础上加知母、黄柏
   
3. 杞菊地黄丸 (fitness: 0.85)
   滋肾养肝明目，在六味地黄丸基础上加枸杞、菊花

提示：搜索无结果时自动重试
AI Agent 在搜索无结果时，会自动提取更短的核心名词并减少筛选条件再次重试。例如搜索"六味地黄丸配方"无结果时，会自动改用"地黄"重试。

技术细节

项目	说明
协议	FastMCP streamable-http
端点	`https://ixno.com/mcp`
传输	HTTPS POST
认证	无需认证
CORS	已启用（支持浏览器端调用）
频控	IP 轻量频控，正常使用不受影响