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帮助中心

许可证

麻省理工学院