Dixa MCP Server

🚀 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 を使用したサーバーテスト例：
npx fastmcp dev src/tools/index.ts

# MCP Inspector を使用したサーバーテスト例：
npx fastmcp inspect src/tools/index.ts

💻 使用例

Claude での設定

このサーバーを Claude で使用するには、以下の手順を行います。

1. 開発モードを開く
2. Claude で、設定 > 開発者 > 編集設定に移動する
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"
      }
    }
  }
}

Server-Sent Events (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: フィルター、期間、および集計を使用して特定の指標の分析データを取得します。