phinix_experience 0.0.1

package/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(node --check src/server.js)",
+      "Bash(node --check src/tools/searchExperience.js)",
+      "Bash(node --check src/tools/index.js)"
+    ]
+  }
+}

package/README.md

@@ -0,0 +1,149 @@
+# phinix_experience MCP 服务器
+
+phinix_experience 是一个基于 Model Context Protocol (MCP) 的服务器，为 AI 模型提供项目开发经验检索功能，帮助开发者在编码前查阅相关踩坑经验，避免重复犯错。
+
+## 功能特性
+
+### 🔍 经验列表检索 (`search_experience_list`)
+
+- 根据关键词搜索项目开发经验库
+- 返回匹配的经验列表（包含 id 和概述）
+- 支持自然语言描述查询
+
+### 📄 经验详情获取 (`search_experience_detail`)
+
+- 根据经验 ID 获取完整的经验详情
+- 包含详细的问题描述、解决方案和注意事项
+
+## 安装和使用
+
+### 环境要求
+
+- Node.js 18+
+- npm 或 yarn
+
+### 安装依赖
+
+```bash
+npm install
+```
+
+### 环境变量
+
+| 变量名   | 必需 | 说明                      |
+| -------- | ---- | ------------------------- |
+| `APP_ID` | 是   | RAG 应用 ID，用于经验检索 |
+
+### 启动服务器
+
+```bash
+npm start
+```
+
+### 在 IDE 中配置 MCP
+
+```json
+{
+  "mcpServers": {
+    "phinix_experience": {
+      "command": "node",
+      "args": ["src/index.js"],
+      "cwd": "/path/to/phinix_experience",
+      "env": {
+        "APP_ID": "your-app-id"
+      }
+    }
+  }
+}
+```
+
+## MCP 工具说明
+
+### 1. search_experience_list
+
+编码前检索项目开发经验库，查找与当前任务相关的踩坑经验。
+
+**参数：**
+
+| 参数    | 类型   | 必需 | 说明                           |
+| ------- | ------ | ---- | ------------------------------ |
+| `query` | string | 是   | 搜索查询词，描述当前任务或问题 |
+
+**返回：**
+
+匹配的经验列表，每条包含：
+
+- `id`: 经验唯一 ID
+- `text`: 经验概述
+
+**示例：**
+
+```json
+{"query": "scss 样式"}
+{"query": "表格列配置"}
+{"query": "接口请求错误处理"}
+```
+
+### 2. search_experience_detail
+
+获取某条经验的完整详情。
+
+**参数：**
+
+| 参数 | 类型   | 必需 | 说明                                          |
+| ---- | ------ | ---- | --------------------------------------------- |
+| `id` | number | 是   | 经验唯一 ID（从 search_experience_list 获取） |
+
+**返回：**
+
+经验的完整详情内容。
+
+**示例：**
+
+```json
+{ "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
+
+## 开发
+
+```bash
+# 开发模式（监听文件变化自动重启）
+npm run dev
+
+# 使用 MCP Inspector 调试
+npm run serve
+```
+
+## 许可证
+
+MIT License

package/debug-client.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+
+async function debugMcpServer() {
+  const transport = new StdioClientTransport({
+    command: "node",
+    args: ["src/index.js"],
+  });
+
+  const client = new Client(
+    {
+      name: "debug-client",
+      version: "1.0.0",
+    },
+    {
+      capabilities: {},
+    },
+  );
+
+  try {
+    console.log("🔌 连接到MCP服务器...");
+    await client.connect(transport);
+    console.log("✅ 连接成功!");
+
+    // 1. 获取工具列表
+    console.log("\n📋 获取工具列表:");
+    const tools = await client.listTools();
+    console.log(JSON.stringify(tools, null, 2));
+
+    // 2. 测试经验检索
+    console.log("\n🔍 测试 search_experience_list:");
+    const result1 = await client.callTool({
+      name: "search_experience_list",
+      arguments: { query: "样式问题" },
+    });
+    console.log("响应:", JSON.stringify(result1, null, 2));
+
+    // 3. 测试经验详情（使用示例 ID）
+    console.log("\n📄 测试 search_experience_detail:");
+    const result2 = await client.callTool({
+      name: "search_experience_detail",
+      arguments: { id: 1 },
+    });
+    console.log("响应:", JSON.stringify(result2, null, 2));
+  } catch (error) {
+    console.error("❌ 调试失败:", error);
+  } finally {
+    await client.close();
+    console.log("\n🔌 连接已关闭");
+  }
+}
+
+debugMcpServer().catch(console.error);

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+// 简单的入口点，导入并启动服务器
+import './server.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":";AAEA,kBAAkB;AAClB,OAAO,aAAa,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.js"],"names":[],"mappings":""}

package/dist/server.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { searchExperienceListSchema, searchExperienceList, searchExperienceDetailSchema, searchExperienceDetail, } from "./tools/index.js";
+// 使用功能更完整的McpServer
+const server = new McpServer({
+    name: "phinix_experience",
+    version: "0.0.1",
+    description: `phinix_experience MCP服务器 - 开发经验检索助手
+
+🎯 核心功能：
+- 检索项目开发经验库，避免重复踩坑
+- 获取经验详情
+
+📊 推荐的工具调用流程：
+1. search_experience_list（搜索相关经验）
+2. search_experience_detail（获取经验详情）`,
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+server.tool("search_experience_list", `【编码前必查】检索项目开发经验库
+
+### When to Use:
+- 开始新增或修改代码前，检索与任务相关的踩坑经验，避免重复犯错
+
+### Input:
+- query: 搜索查询词，描述当前任务或问题
+
+### Output:
+返回匹配的经验列表，每条包含：
+- id: 经验唯一ID（可用于调用 search_experience_detail 获取详情）
+- text: 经验概述
+
+### Examples:
+- search_experience_list(query="scss 样式")
+- search_experience_list(query="AutoTable 表格列配置")`, searchExperienceListSchema, searchExperienceList);
+server.tool("search_experience_detail", `获取经验详情
+
+### When to Use:
+- 在 search_experience_list 返回结果后，根据 id 获取某条经验的完整详情
+
+### Input:
+- id: 经验的唯一ID（number类型，从 search_experience_list 结果中获取）
+
+### Output:
+返回经验的完整详情`, searchExperienceDetailSchema, searchExperienceDetail);
+// 启动服务器
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("🚀 phinix_experience MCP Server started on stdio");
+    console.error("📋 Available tools: search_experience_list, search_experience_detail");
+}
+main().catch((error) => {
+    console.error("Failed to start MCPServer:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.js"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,oBAAoB;AACpB,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;IACE,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE;;;;;;;;oCAQmB;CACjC,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB;;;;;;;;;;;;;;;kDAegD,EAChD,0BAA0B,EAC1B,oBAAoB,CACrB,CAAC;AAEF,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B;;;;;;;;;UASQ,EACR,4BAA4B,EAC5B,sBAAsB,CACvB,CAAC;AAEF,QAAQ;AACR,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAClE,OAAO,CAAC,KAAK,CACX,sEAAsE,CACvE,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;IACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,2 @@
+export { searchExperienceListSchema, searchExperienceList, searchExperienceDetailSchema, searchExperienceDetail } from "./searchExperience.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.js"],"names":[],"mappings":""}

package/dist/tools/index.js

@@ -0,0 +1,3 @@
+// 经验检索相关
+export { searchExperienceListSchema, searchExperienceList, searchExperienceDetailSchema, searchExperienceDetail, } from "./searchExperience.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.js"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC"}

package/dist/tools/searchExperience.d.ts

@@ -0,0 +1,20 @@
+export function searchExperienceList(params: any): Promise<{
+    content: {
+        type: string;
+        text: any;
+    }[];
+}>;
+export function searchExperienceDetail(params: any): Promise<{
+    content: {
+        type: string;
+        text: any;
+    }[];
+}>;
+export namespace searchExperienceListSchema {
+    let query: z.ZodString;
+}
+export namespace searchExperienceDetailSchema {
+    let id: z.ZodNumber;
+}
+import { z } from "zod";
+//# sourceMappingURL=searchExperience.d.ts.map

package/dist/tools/searchExperience.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchExperience.d.ts","sourceRoot":"","sources":["../../src/tools/searchExperience.js"],"names":[],"mappings":"AAaA;;;;;GA6EC;AAMD;;;;;GAmDC;;;;;;;kBAnJiB,KAAK"}

package/dist/tools/searchExperience.js

@@ -0,0 +1,133 @@
+import { z } from "zod";
+// 跳过内网 TLS 证书验证
+process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";
+const API_URL = "https://giti.lydaas.com/api/ai/exp/rag";
+const APP_ID = process.env.APP_ID;
+const DETAIL_BASE_URL = "https://giti.lydaas.com/api/ai/exp/detail";
+export const searchExperienceListSchema = {
+    query: z.string().describe("搜索查询词，描述当前任务或问题"),
+};
+export async function searchExperienceList(params) {
+    try {
+        const { query } = params;
+        const response = await fetch(API_URL, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                appId: APP_ID,
+                query,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${await response.text()}`);
+        }
+        const data = await response.json();
+        if (data.code !== 200 || !data.data) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: data.message || `未找到与「${query}」相关的经验记录。`,
+                    },
+                ],
+            };
+        }
+        const text = data.data.output?.text;
+        let output = [];
+        try {
+            output = JSON.parse(text);
+        }
+        catch {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `未找到与「${query}」相关的经验记录。`,
+                    },
+                ],
+            };
+        }
+        if (!Array.isArray(output) || output.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `未找到与「${query}」相关的经验记录。`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(output),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `经验检索失败: ${error.message}`,
+                },
+            ],
+        };
+    }
+}
+export const searchExperienceDetailSchema = {
+    id: z.number().describe("经验的唯一ID"),
+};
+export async function searchExperienceDetail(params) {
+    try {
+        const { id } = params;
+        const response = await fetch(`${DETAIL_BASE_URL}/${id}`);
+        if (!response.ok) {
+            if (response.status === 404) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `未找到 id=${id} 的经验`,
+                        },
+                    ],
+                };
+            }
+            throw new Error(`HTTP ${response.status}: ${await response.text()}`);
+        }
+        const result = await response.json();
+        if (result.code !== 200 || !result.data) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: result.message || `未找到 id=${id} 的经验`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result.data),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `经验详情获取失败: ${error.message}`,
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=searchExperience.js.map

package/dist/tools/searchExperience.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchExperience.js","sourceRoot":"","sources":["../../src/tools/searchExperience.js"],"names":[],"mappings":"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"}

package/mcp-config.json

@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "phinix_experience": {
+      "command": "node",
+      "args": ["src/index.js"],
+      "cwd": ".",
+      "env": {}
+    }
+  }
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "phinix_experience",
+  "version": "0.0.1",
+  "description": "phinix_experience - A Model Context Protocol server for searching development experience",
+  "main": "dist/index.js",
+  "bin": {
+    "phinix_experience": "dist/index.js"
+  },
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "start": "tsx src/index.js",
+    "dev": "tsx --watch src/index.js",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "prepublishOnly": "npm run build",
+    "serve": "npx @modelcontextprotocol/inspector node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "experience-search",
+    "development-experience",
+    "analytics"
+  ],
+  "author": "Dataphin Team",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.9.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.3",
+    "@types/node": "^20.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git@gitlab.alibaba-inc.com:nel/phinpilot.git"
+  }
+}

package/quick-test.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+
+async function quickTest() {
+  const transport = new StdioClientTransport({
+    command: "node",
+    args: ["src/index.js"],
+  });
+
+  const client = new Client(
+    {
+      name: "quick-test",
+      version: "1.0.0",
+    },
+    {
+      capabilities: {},
+    },
+  );
+
+  try {
+    await client.connect(transport);
+
+    console.log("🧪 测试 phinix_experience MCP 工具集\n");
+
+    // 测试 search_experience_list
+    console.log("🔍 测试 search_experience_list:");
+    const listResult = await client.callTool({
+      name: "search_experience_list",
+      arguments: { query: "scss 样式" },
+    });
+
+    if (listResult.content && listResult.content[0]) {
+      console.log("✅ 经验检索成功");
+      console.log("返回内容:", listResult.content[0].text.substring(0, 200));
+    } else {
+      console.log("❌ 经验检索未返回结果");
+    }
+
+    // 测试 search_experience_detail
+    console.log("\n📄 测试 search_experience_detail:");
+    const detailResult = await client.callTool({
+      name: "search_experience_detail",
+      arguments: { id: 1 },
+    });
+
+    if (detailResult.content && detailResult.content[0]) {
+      console.log("✅ 经验详情获取成功");
+      console.log("返回内容:", detailResult.content[0].text.substring(0, 200));
+    } else {
+      console.log("❌ 经验详情未返回结果");
+    }
+  } catch (error) {
+    console.error("❌ 测试失败:", error);
+  } finally {
+    await client.close();
+  }
+}
+
+quickTest().catch(console.error);