# IXNO — AI 工具基因池 (Gene Pool & MCP Gateway)

IXNO 是一个供 AI Agent 免费、免 Key 直连的只读工具库网关。12000+ 条经过进化验证的代码基因，覆盖中医、软件开发、AI 智能体、办公效率四大领域。

## 核心接入方式

### MCP (Model Context Protocol)
- 兼容 Claude Desktop, Cursor, Qoder 等
- Endpoint: `https://ixno.com/mcp`
- 协议: FastMCP streamable-http
- 工具: health / stats / search

### REST API (Base URL: https://ixno.com)
- 基因搜索: `GET /api/v1/search?q=<keyword>&category=<大类>&sub=<子类>&limit=20`
- 统计面板: `GET /api/v1/stats`
- 单条基因: `GET /api/v1/genes/<gene_id>`
- 健康检查: `GET /api/v1/health`

### 官方 SDK
- Python: `pip install ixno-sdk`
- TypeScript: `npm install ixno-sdk-ts`

## 搜索参数说明
- `q` (必填): 搜索关键词，支持中英文
- `category` (可选): 大类筛选 — 中医 / 软件开发 / AI / 办公技能 / External
- `sub` (可选): 子类筛选（33 子类，如 经方、方剂学、前端、后端 等）
- `limit` (可选): 返回条数，默认 20，最大 100

## 搜索返回格式
```json
{
  "query": "关键词",
  "total": 42,
  "results": [
    {
      "gene_id": "xxx",
      "name": "xxx",
      "desc": "描述",
      "fitness": 0.95,
      "domain": "中医",
      "layer": "S0",
      "tags": "[...]",
      "_score": 6.15
    }
  ]
}
```

## 使用建议
- 搜索无结果时，缩短关键词重试（如"六味地黄丸" → "地黄"）
- fitness > 0.8 的基因质量最高，优先参考
- 免 Key 读，写操作需单 Key（IP 轻量频控）
- 完整 OpenAPI 规范: https://ixno.com/openapi.json

## 技术文章
- https://ixno.com/article.html — 13 篇深度技术文章，从 MCP 接入到进化引擎原理

## 开源
- Paladin Agent: https://github.com/amyicf79/paladin-agent
- IXNO SDK: https://github.com/amyicf79/ixno-sdk