AI导哈

知识库访问服务器

一个提供实时访问Engage Victoria帮助中心知识的MCP服务器，通过Zendesk API获取最新信息，支持搜索和分类浏览功能。

  • by Bcrook123
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Bcrook123/engage-victoria-mcp-server

使用说明

参与维多利亚知识MCP服务器

一个模型上下文协议（MCP）服务器，提供直接从Zendesk访问Engage Victoria帮助中心的最新信息。

特性

  • 从Engage Victoria帮助中心的文章中获取实时内容
  • 使用Zendesk API在知识库内容中搜索
  • 列出所有可用的类别和部分
  • 始终保持最新信息（无过时缓存）
  • 针对Zendesk帮助中心进行了优化
  • 从HTML中提取干净的文本
  • 在Docker中运行，便于部署

这有什么作用

该MCP服务器允许Claude（或任何MCP客户）使用Zendesk API实时访问Engage Victoria帮助中心。它专门针对与Civio/District Engage知识库分开的Engage Victoria帮助中心（ID:9305921909647）。

Docker快速入门

1.克隆存储库

git clone https://github.com/Bcrook123/engage-victoria-mcp-server.git
cd engage-victoria-mcp-server

2.创建环境文件

创建一个 .env 根目录中的文件：

ZENDESK_EMAIL=simon@district.au
ZENDESK_API_TOKEN=your-api-token-here

安全说明：永远不要承诺 .env 文件到git。它已经在里面了 .gitignore.

3.使用Docker构建和运行

docker-compose up -d --build

这将：

  • 构建Docker镜像
  • 在后台启动容器
  • 使MCP服务器可用于Claude Desktop

4.配置克劳德桌面

将此添加到您的Claude Desktop配置文件中：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "engage-victoria-knowledge": {
      "command": "docker",
      "args": ["exec", "-i", "engage-victoria-mcp", "node", "/app/dist/index.js"]
    }
  }
}

备注：如果您已经配置了Civio连接器，则配置如下：

{
  "mcpServers": {
    "engage-knowledge-web": {
      "command": "docker",
      "args": ["exec", "-i", "civio-mcp", "node", "/app/dist/index.js"]
    },
    "engage-victoria-knowledge": {
      "command": "docker",
      "args": ["exec", "-i", "engage-victoria-mcp", "node", "/app/dist/index.js"]
    }
  }
}

5.重新启动克劳德桌面

添加配置后，完全重新启动Claude Desktop。

手动设置（非Docker）

如果你想在没有Docker的情况下运行：

1.安装依赖项

npm install

2.构建服务器

npm run build

3.配置克劳德桌面

{
  "mcpServers": {
    "engage-victoria-knowledge": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/engage-victoria-mcp-server/dist/index.js"],
      "env": {
        "ZENDESK_EMAIL": "simon@district.au",
        "ZENDESK_API_TOKEN": "your-api-token-here",
        "ZENDESK_HELP_CENTER_ID": "9305921909647"
      }
    }
  }
}

验证安装

配置后，通过询问Claude来测试它：

  • “Engage Victoria知识库中有哪些类别？”
  • “在Engage Victoria寻找社区参与”
  • “列出Engage Victoria帮助中心部分”

可用工具

列表_类别

列出Engage Victoria知识库中的所有可用类别和部分。

参数： 无

例子：

What categories are available in Engage Victoria?

fetch_文章

按ID从特定知识库文章中获取最新内容。

参数：

  • article_id （必填）：Zendesk文章ID

例子：

Fetch article 123456789 from Engage Victoria

搜索内容

使用Zendesk搜索API在Engage Victoria知识库中搜索文章。

参数：

  • query （必填）：搜索词或主题

例子：

Search for "project planning" in Engage Victoria knowledge base

Docker管理

查看日志

docker-compose logs -f

停止集装箱

docker-compose down

重新启动容器

docker-compose restart

更改后重建

docker-compose up -d --build

故障排除

容器未启动

检查日志：

docker-compose logs

API凭据不起作用

验证您的凭据：

docker exec -it engage-victoria-mcp env | grep ZENDESK

Claude Desktop无法连接

  1. 确保容器正在运行： docker ps
  2. 完全重新启动克劳德桌面
  3. 检查Claude Desktop日志中的连接错误

与Civio连接器的主要区别

  • 帮助中心ID：9305921909647（与维多利亚交战）vs 9038131156495（Civio）
  • API终点：所有API调用的范围均为Engage Victoria帮助中心
  • 容器名称: engage-victoria-mcp （不同于 civio-mcp)
  • 服务器名称: engage-victoria-knowledge （不同于 engage-knowledge-web)

安全注意事项

重要：

  • 这是一个 私有存储库 -只有授权的地区团队成员才能访问
  • 需要Zendesk凭据
  • API令牌应被视为密码-确保它们的安全！
  • 永不承诺 .env 文件到git
  • 对敏感数据使用环境变量

技术架构

  • 帮助中心ID：硬编码为9305921909647（与维多利亚交战）
  • 相同的API令牌：使用与Civio相同的Zendesk凭据
  • 独立实例：作为完全独立的MCP服务器运行
  • API范围界定：所有Zendesk API调用都明确针对EV帮助中心

许可证

麻省理工学院

相关 MCP