Dixa MCP 服务器

Dixa API 的 FastMCP 服务器实现，提供用于管理对话和标签的资源和工具。

特征

资源
- 搜索对话
- 获取对话详细信息
- 获取对话记录
- 获取对话消息
- 获取可用标签
工具
- 为对话添加标签
- 从对话中删除标签

项目结构

/src
├── dixa.ts              # Main server setup
├── config.ts            # Configuration and environment settings
├── types.ts             # Shared types and error handling
├── resources/           # Resource implementations
├── schemas/            # Zod schemas for validation
└── tools/             # Tool implementations

配置

服务器需要以下环境变量：

DIXA_API_KEY ：您的 Dixa API 密钥
DIXA_API_BASE_URL （可选）：覆盖默认 API URL（默认为“ https://dev.dixa.io/v1 ”）

用法

设置环境变量：

   export DIXA_API_KEY='your-api-key'

启动服务器：
npm start

## Running Your Server

### Test with `mcp-cli`

The fastest way to test and debug your server is with `fastmcp dev`:

```bash
npx fastmcp dev server.js
npx fastmcp dev server.ts

这将使用mcp-cli运行您的服务器，以便在终端中测试和调试您的 MCP 服务器。

使用`MCP Inspector`进行检查

另一种方法是使用官方MCP Inspector通过 Web UI 检查您的服务器：

npx fastmcp inspect server.ts

常问问题

如何与 Claude Desktop 一起使用？

按照指南https://modelcontextprotocol.io/quickstart/user并添加以下配置：

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "npx",
      "args": [
        "tsx",
        "/PATH/TO/YOUR_PROJECT/src/index.ts"
      ],
      "env": {
        "YOUR_ENV_VAR": "value"
      }
    }
  }
}

发展

添加新资源

在src/schemas/中创建一个模式
在src/resources/中创建资源
将资源添加到src/dixa.ts

示例资源：

export const myResource = {
  uri: "dixa://my-resource",
  name: "My Resource",
  description: "Description",
  load: async (args: MyArgs, apiKey: string) => {
    // Implementation
  }
};

添加新工具

在src/tools/中创建工具
将工具添加到src/dixa.ts

示例工具：

export const myTool = {
  name: "My Tool",
  description: "Description",
  execute: async (args: MyArgs, apiKey: string) => {
    // Implementation
  }
};

错误处理

该项目使用自定义错误类：

DixaError ：API 错误的基本错误类
DixaValidationError ：响应验证失败

展示

[！笔记]
如果您使用 FastMCP 开发了服务器，请提交 PR来在此处展示它！

https://github.com/apinetwork/piapi-mcp-server
https://github.com/Meeting-Baas/meeting-mcp - 会议 BaaS MCP 服务器，使 AI 助手能够创建会议机器人、搜索记录并管理记录数据

致谢

FastMCP 的灵感来自Jonathan Lowin的Python 实现。
部分代码库取自LiteMCP 。
部分代码库采用模型上下文协议でSSEをやってみる。

贡献

遵循现有的资源和工具模式
添加适当的 JSDoc 文档
使用types.ts和config.ts中的共享实用程序
如果添加新功能，请更新 README

Dixa MCP 服务器

特征

项目结构

配置

用法

使用MCP Inspector进行检查

常问问题

如何与 Claude Desktop 一起使用？

发展

添加新资源

添加新工具

错误处理

展示

致谢

贡献

使用`MCP Inspector`进行检查