AI导哈

TeamDynamix MCP服务端

一款连接AI助手与TeamDynamix实例的服务端，支持通过自然语言搜索和管理工单、知识库文章、人员、资产等项目。

  • by chatt-state
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 chatt-state/teamdynamix-mcp-server

使用说明

TeamDynamix MCP服务器

一 主控程序 将AI助手连接到您的服务器 TeamDynamix 例子通过自然语言搜索和管理工单、知识库文章、人员、资产、项目、时间条目、报告、服务目录和自定义属性。

特性

  • 决策树导航 --启动时仅加载2个工具；域工具按需加载
  • 9个域名 --票证、知识库、人员、资产、项目、时间、报告、服务目录、属性
  • 38工具 所有域的总计
  • 互动启发 --当未提供ID时，提示输入票证类型、资产状态/表单、KB类别、时间类型和服务类别
  • 克劳德插件 --指导工作流程的技能和命令
  • 多个传输 --stdio（默认）和可流式传输HTTP

可用工具

始终加载

工具 说明
tdx_navigate 加载域工具集（票证、知识库、人员、资产、项目、报告、时间、service_catalog、属性）
tdx_status 服务器状态和已加载的域

门票域名

工具 说明
tdx_tickets_search 按文本、状态、优先级、类型、组搜索门票
tdx_tickets_get 通过ID获取完整的门票详细信息
tdx_tickets_create 创建新票证（交互式类型选择）
tdx_tickets_update 更新现有工单

知识库域

工具 说明
tdx_kb_search 搜索知识库文章
tdx_kb_get_article 获取完整文章内容
tdx_kb_create_article 创建新的知识库文章（交互式类别选择）
tdx_kb_get_categories 列出所有知识库类别

人域

工具 说明
tdx_people_search 按姓名、电子邮件或部门搜索人员
tdx_people_get 按UID获取人员详细信息

资产域

工具 说明
tdx_assets_search 搜索资产/CI
tdx_assets_get 按ID获取资产详细信息
tdx_assets_create 创建新资产（交互状态/表单选择）

项目领域

工具 说明
tdx_projects_search 按文本、状态、帐户搜索项目
tdx_projects_get 按ID获取完整的项目详细信息
tdx_projects_create 创建新项目
tdx_projects_update 更新现有项目

时域

工具 说明
tdx_time_search 按日期范围和资源搜索时间条目
tdx_time_get 按ID获取全职入职详细信息
tdx_time_create 记录新的时间条目（交互式类型选择）
tdx_time_update 更新现有时间条目
tdx_time_delete 删除时间条目
tdx_time_get_types 列出所有可用的时间类型

报告域

工具 说明
tdx_reports_search 按名称搜索报告
tdx_reports_get 按ID获取报告元数据
tdx_reports_execute 执行报告并返回数据行

服务目录域

工具 说明
tdx_services_search 搜索服务目录
tdx_services_get 按ID获取完整的服务详细信息
tdx_services_create 创建新服务（交互式类别选择）
tdx_services_update 更新现有服务
tdx_services_search_offerings 在服务中搜索产品
tdx_services_get_offering 获取完整的产品详情
tdx_services_create_offering 在服务中创建新产品
tdx_services_update_offering 更新现有产品
tdx_services_get_categories 列出所有服务类别

属性域

工具 说明
tdx_attributes_list 列出组件的自定义属性定义
tdx_attributes_get_choices 获取属性的选择列表选项
tdx_attributes_create_choice 添加新的选择列表选项
tdx_attributes_update_choice 更新现有的选择列表选项
tdx_attributes_delete_choice 删除选择列表选项

先决条件

  • Node.js 20+
  • 启用API访问的TeamDynamix实例
  • 管理服务帐户凭据（BEID+Web服务密钥）

查找您的凭据

  1. 登录 Tdadmin 在 https://yourinstance.teamdynamix.com/TDAdmin
  2. 首选 组织详情 → 安全 部分
  3. 复制 Web服务BEID 和 Web服务密钥
  4. 您需要“添加BE管理员”权限才能查看这些值

安装

克劳德插件市场

使用指导技能和工作流程作为Claude Code插件安装：

/plugin marketplace add chatt-state/teamdynamix-mcp-server
/plugin install teamdynamix@teamdynamix-mcp-server

设置所需的环境变量：

export TDX_BASE_URL=https://yourinstance.teamdynamix.com
export TDX_BEID=your-beid-guid
export TDX_WEB_SERVICES_KEY=your-web-services-key

克劳德桌面/克劳德代码

添加到MCP配置(claude_desktop_config.json 或 .mcp.json):

{
  "mcpServers": {
    "teamdynamix": {
      "command": "npx",
      "args": ["-y", "--registry", "https://npm.pkg.github.com", "@chatt-state/teamdynamix-mcp-server"],
      "env": {
        "TDX_BASE_URL": "https://yourinstance.teamdynamix.com",
        "TDX_BEID": "your-beid-guid",
        "TDX_WEB_SERVICES_KEY": "your-web-services-key"
      }
    }
  }
}

码头工人

docker run --rm -i \
  -e TDX_BASE_URL=https://yourinstance.teamdynamix.com \
  -e TDX_BEID=your-beid-guid \
  -e TDX_WEB_SERVICES_KEY=your-web-services-key \
  ghcr.io/chatt-state/teamdynamix-mcp-server:latest

Docker MCP网关

Docker镜像包括用于自动发现的MCP网关元数据：

docker mcp server enable teamdynamix-mcp-server \
  --image ghcr.io/chatt-state/teamdynamix-mcp-server:latest

来源

git clone https://github.com/chatt-state/teamdynamix-mcp-server.git
cd teamdynamix-mcp-server
npm install
npm run build

配置

环境变量 必填 说明
TDX_BASE_URL 是 您的TeamDynamix实例URL
TDX_BEID 是 API BEID（GUID格式）
TDX_WEB_SERVICES_KEY 是 API Web服务密钥（GUID格式）
TDX_TICKETING_APP_ID 否 票务应用ID
TDX_ASSETS_APP_ID 否 资产/CI应用程序ID
TDX_KB_APP_ID 否 知识库应用程序ID
TDX_SERVICE_CATALOG_APP_ID 否 服务目录应用程序ID
TDX_MCP_TRANSPORT 没有 stdio （默认）或 http

用法

连接后，询问您的AI助手以下问题：

  • “搜索有关VPN问题的未结票证”
  • “查找有关密码重置的知识库文章”
  • “查找分配给IT部门的所有资产”
  • “为新的笔记本电脑请求创建工单”
  • “显示所有活动项目”
  • “根据12345号票记录2小时”
  • “运行月度SLA报告”
  • “在服务目录中搜索电子邮件服务”
  • “列出门票的自定义属性”

助手将通过以下方式自动加载相关域工具 tdx_navigate 在执行搜索之前。

建筑

服务器使用 决策树延迟加载 图案：

  1. 启动时，仅 tdx_navigate 和 tdx_status 已注册
  2. 当AI呼叫时 tdx_navigate("tickets")，票证域工具动态加载
  3. 服务器通过以下方式通知客户端 tools/list_changed
  4. 后续调用使用新注册的域工具

这使得初始工具占用空间很小——对于工具上下文有限的LLM来说很重要。

文档

完整文档请访问 chatt-state.github.io/teamdynamic-mcp服务器

发展

npm run build      # Compile TypeScript
npm run test       # Run tests (vitest)
npm run lint       # ESLint + format checks
npm run typecheck  # TypeScript type checking

许可证

麻省理工学院

相关 MCP