Dixa MCP 服务器

这是一个 FastMCP 服务器，提供与 Dixa API 交互的工具。它允许你搜索对话、获取对话详情、管理标签等等。

运行服务器

要运行服务器，你需要：

1. 安装依赖：

npm install
npm install fastmcp

2. 设置你的环境变量：

cp .env.example .env

然后编辑 .env 并添加你的 Dixa API 密钥：

DIXA_API_KEY=your_api_key_here

3. 启动服务器：

# 使用 CLI 测试 addition server 示例：
npx fastmcp dev src/tools/index.ts

# 使用 MCP Inspector 测试 addition server 示例：
npx fastmcp inspect src/tools/index.ts

在 Claude 中设置

要在 Claude 中使用此服务器：

1. 开启开发者模式
2. 在 Claude 中，进入 Settings > Developer > Edit Config
3. 添加以下配置

{
  "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"
      }
    }
  }
}

服务器发送事件 (SSE)

你也可以使用 SSE 支持运行服务器：

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

这将启动服务器并监听 http://localhost:8080/sse 上的 SSE 连接。

然后你可以使用 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);

已实现的工具

对话管理

• searchConversations: 在 Dixa 中搜索对话，支持分页
• getConversation: 通过 ID 获取单个对话
• getConversationMessages: 获取特定对话的所有消息
• getConversationTags: 获取与对话关联的所有标签
• getConversationNotes: 获取对话的所有内部备注
• getConversationRatings: 获取对话的所有评分

标签管理

• listTags: 列出 Dixa 中所有可用的标签
• tagConversation: 将标签添加到特定对话
• removeConversationTag: 从特定对话中删除标签

最终用户管理

• getEndUser: 获取有关特定最终用户的信息
• getEndUserConversations: 获取特定最终用户的所有对话

代理管理

• getAgent: 获取有关特定代理的信息
• listAgents: 列出所有代理，支持可选过滤

分析

• getAnalyticsMetric: 获取有关特定分析指标的详细信息
• getAnalyticsRecord: 获取有关特定分析记录的详细信息
• listAnalyticsRecords: 列出所有可用的分析记录 ID
• listAnalyticsMetrics: 列出所有可用的分析指标 ID
• getAnalyticsFilter: 获取给定分析筛选器属性的可能值
• getAnalyticsRecordsData: 获取特定记录的分析数据，支持筛选器和时间段设置
• getAnalyticsMetricsData: 获取特定指标的分析数据，支持筛选器、时间段设置和聚合