Dixa MCP 服务器
Dixa API 的 FastMCP 服务器实现,提供用于管理对话和标签的资源和工具。
特征
资源
搜索对话
获取对话详细信息
获取对话记录
获取对话消息
获取可用标签
工具
为对话添加标签
从对话中删除标签
Related MCP server: ReActMCP Web Search
项目结构
/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/Meeting-Baas/meeting-mcp - 会议 BaaS MCP 服务器,使 AI 助手能够创建会议机器人、搜索记录并管理记录数据
致谢
FastMCP 的灵感来自Jonathan Lowin的Python 实现。
部分代码库取自LiteMCP 。
部分代码库采用模型上下文协议でSSEをやってみる。
贡献
遵循现有的资源和工具模式
添加适当的 JSDoc 文档
使用
types.ts和config.ts中的共享实用程序如果添加新功能,请更新 README