Dixa MCP Server

基本能力

产品定位

Dixa MCP Server 是一个用于与 Dixa API 交互的工具集，主要面向需要集成 Dixa 功能的开发者和团队。

核心功能

1. 对话管理：搜索对话、获取对话详情、消息、标签、内部笔记和评分。
2. 标签管理：列出所有标签、为对话添加或移除标签。
3. 终端用户管理：获取终端用户信息及其对话记录。
4. 代理管理：获取代理信息及列表。
5. 分析：获取分析指标、记录及其数据。

适用场景

• 需要与 Dixa 平台集成的开发者。
• 需要自动化管理 Dixa 对话和标签的团队。
• 需要获取 Dixa 分析数据的业务人员。

工具列表

1. Conversation Management：
2. searchConversations：支持分页搜索对话。
3. getConversation：通过 ID 获取单个对话。
4. getConversationMessages：获取对话的所有消息。
5. getConversationTags：获取对话的所有标签。
6. getConversationNotes：获取对话的所有内部笔记。

7. getConversationRatings：获取对话的所有评分。

8. Tag Management：

9. listTags：列出所有可用标签。
10. tagConversation：为对话添加标签。

11. removeConversationTag：从对话中移除标签。

12. End User Management：

13. getEndUser：获取终端用户信息。

14. getEndUserConversations：获取终端用户的所有对话。

15. Agent Management：

16. getAgent：获取代理信息。

17. listAgents：列出所有代理（可选过滤）。

18. Analytics：

19. getAnalyticsMetric：获取特定分析指标的详细信息。
20. getAnalyticsRecord：获取特定分析记录的详细信息。
21. listAnalyticsRecords：列出所有可用的分析记录 ID。
22. listAnalyticsMetrics：列出所有可用的分析指标 ID。
23. getAnalyticsFilter：获取给定分析筛选属性的可能值。
24. getAnalyticsRecordsData：获取特定记录的分析数据（带筛选和周期设置）。
25. getAnalyticsMetricsData：获取特定指标的分析数据（带筛选、周期设置和聚合）。

使用教程

使用依赖

1. 安装依赖：

npm install
npm install fastmcp

1. 设置环境变量：

cp .env.example .env

然后编辑 .env 文件，添加 Dixa API 密钥：

DIXA_API_KEY=your_api_key_here

安装教程

1. 启动服务器：

# 使用 CLI 测试服务器示例：
npx fastmcp dev src/tools/index.ts

# 使用 MCP Inspector 测试服务器示例：
npx fastmcp inspect src/tools/index.ts

1. 在 Claude 中设置：
2. 打开开发模式。
3. 在 Claude 中，转到 Settings > Developer > Edit Config。
4. 添加以下配置：

{
  "mcpServers": {
    "dixa-mcp-server": {
      "command": "npx",
      "args": [
        "tsx",
        "/PATH/TO/FOLDER/dixa-mcp-server/src/tools/index.ts"
      ],
      "env": {
        "DIXA_API_KEY": "YOUR_API_KEY_TO_DIXA"
      }
    }
  }
}

调试方式

1. 使用 SSE 支持运行服务器：

server.start({
  transportType: "sse",
  sse: {
    endpoint: "/sse",
    port: 8080,
  },
});

1. 使用 SSEClientTransport 连接到服务器：

import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";

const client = new Client(
  {
    name: "example-client",
    version: "1.0.0",
  },
  {
    capabilities: {},
  },
);

const transport = new SSEClientTransport(new URL(`http://localhost:8080/sse`));

await client.connect(transport);

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。