phinix_experience MCP 服务器

phinix_experience 是一个基于 Model Context Protocol (MCP) 的服务器，为 AI 模型提供项目开发经验检索功能，帮助开发者在编码前查阅相关踩坑经验，避免重复犯错。

功能特性

🔍 经验列表检索 (search_experience_list)

• 根据关键词搜索项目开发经验库
• 返回匹配的经验列表（包含 id 和概述）
• 支持自然语言描述查询

📄 经验详情获取 (search_experience_detail)

• 根据经验 ID 获取完整的经验详情
• 包含详细的问题描述、解决方案和注意事项

安装和使用

环境要求

• Node.js 18+
• npm 或 yarn

安装依赖

npm install

环境变量

| 变量名 | 必需 | 说明 | | -------- | ---- | ------------------------- | | APP_ID | 是 | RAG 应用 ID，用于经验检索 |

启动服务器

npm start

在 IDE 中配置 MCP

{
  "mcpServers": {
    "phinix_experience": {
      "command": "npx",
      // 线上
      "args": ["phinix_experience"],
      // 本地测试
      // "args": ["tsx", "/project/ai_experience/src/index.js"],
      "env": {
        "APP_ID": "dataphin"
      }
    },
  }
}

MCP 工具说明

1. search_experience_list

编码前检索项目开发经验库，查找与当前任务相关的踩坑经验。

参数：

| 参数 | 类型 | 必需 | 说明 | | ------- | ------ | ---- | ------------------------------ | | query | string | 是 | 搜索查询词，描述当前任务或问题 |

返回：

匹配的经验列表，每条包含：

• id: 经验唯一 ID
• text: 经验概述

示例：

{"query": "scss 样式"}
{"query": "表格列配置"}
{"query": "接口请求错误处理"}

2. search_experience_detail

获取某条经验的完整详情。

参数：

| 参数 | 类型 | 必需 | 说明 | | ---- | ------ | ---- | --------------------------------------------- | | id | number | 是 | 经验唯一 ID（从 search_experience_list 获取） |

返回：

经验的完整详情内容。

示例：

{ "id": 123 }

推荐使用流程

search_experience_list(query="...") → 获取经验列表 → search_experience_detail(id=xxx) → 获取详情

项目结构

src/
├── index.js                # 入口文件
├── server.js               # MCP 服务器核心，注册工具
├── config.js               # 埋点统计配置
├── analytics/              # 埋点统计模块
│   ├── index.ts
│   ├── reporter.ts
│   ├── tracker.ts
│   └── types.ts
└── tools/
    ├── index.js            # 工具导出入口
    └── searchExperience.js # 经验检索工具实现

技术栈

• MCP SDK: @modelcontextprotocol/sdk
• Schema 验证: Zod
• Transport: STDIO（标准输入输出）
• 运行时: tsx

开发

# 开发模式（监听文件变化自动重启）
npm run dev

# 使用 MCP Inspector 调试
npm run serve

许可证

MIT License