Confluence内容解析服务

AdformMcp是一个模型上下文协议(MCP)服务器,使AI助手能够直接获取和解析Confluence内容。

  • by ksadform
  • C#
  • 本地部署
  • 更新于
在 GitHub 查看 ksadform/AdformMcp

使用说明

AdformMcp-MCP服务器

模型上下文协议(MCP)服务器,使AI助手能够直接获取和解析Confluence内容。

先决条件

获取您的Confluence API代币

  1. 访问 Atlassian API代币管理器
  2. 点击 “创建API令牌”
  3. 给它一个描述性标签(例如“MCP服务器”)
  4. 复制并保存生成的令牌 -您需要它进行配置

安装和权限

下载

  1. 去 发布 页
  2. 下载适用于Mac的二进制文件:
    • 苹果硅(M1/M2/M3): AdformMcp-osx-arm64.tar.gz
    • 英特尔Mac: AdformMcp-osx-x64.tar.gz
  3. 提取存档:
    tar -xzf AdformMcp-osx-arm64.tar.gz
    
  4. 移动到永久位置:
    mkdir -p ~/bin
    mv AdformMcp ~/bin/
    chmod +x ~/bin/AdformMcp
    
  5. MacOS权限
    xattr -dr com.apple.quarantine ~/bin/AdformMcp
    

用法

配置格式

将此配置添加到MCP客户端设置中:

{
  "adform-mcp-server": {
    "command": "/absolute/path/to/AdformMcp",
    "args": [],
    "env": {
      "CONFLUENCE_EMAIL": "your.email@example.com",
      "CONFLUENCE_TOKEN": "your-api-token-here"
    }
  }
}

设置步骤

  1. 找到MCP客户端的配置文件(请参阅编辑的MCP文档)

  2. 将上述配置与您的实际值相加:

    • 替换 /absolute/path/to/AdformMcp 使用二进制文件的完整路径(例如。, /Users/yourusername/bin/AdformMcp)
    • 替换 your.email@example.com 通过您的Adform电子邮件
    • 替换 your-api-token-here 使用系统必备中的API令牌
  3. 重新启动编辑器/MCP客户端

  4. 通过询问您的AI助手进行验证: “Ping Adform Confluence服务器”

    • 预期响应:“Pong”

寻找绝对路径

要获取二进制文件的完整路径:

# If you placed it in ~/bin/
realpath ~/bin/AdformMcp

# Or use pwd if in the same directory
pwd  # Then append /AdformMcp

可用工具

GetAmplitudeInstruction

获取振幅跟踪实施指南和说明。

参数: 无

例子: “获取振幅跟踪实施指南”

退货: 完整的指南,包括如何实施振幅跟踪的说明

GetAmplitudeData

按ID从Confluence页面获取并解析振幅事件数据。

参数:

  • id (字符串):汇流页ID

例子: “从Confluence页面123456789获取振幅数据”

退货: 从指定汇流页面解析振幅数据表

ImplementAmplitudeEvents

通过将指令指南与Confluence页面中的振幅数据相结合来实现振幅事件。

参数:

  • id (字符串):汇流页ID

例子: “执行汇流页123456789中的振幅事件”

退货: 组合实施指南和Amplitude事件数据已准备好实施。此工具会自动从Confluence页面获取指令指南和特定事件数据。

故障排除

问题 解决方案
“权限被拒绝” 运行 chmod +x /path/to/AdformMcp
“CONFLUENCE_EMAIL未设置” 验证 env 配置中的部分同时包含电子邮件和令牌
未检测到服务器 使用绝对路径(例如。, /Users/name/bin/AdformMcp),不 ~/bin/AdformMcp
错误的架构 请与联系 uname -m:使用 arm64 或 x86_64 相应版本
令牌过期 从Atlassian重新生成新的API令牌
网络问题 确保您可以访问 https://adform.atlassian.net

环境变量

服务器需要这些环境变量(在 env 部分):

  • CONFLUENCE_EMAIL:您的Adform Confluence电子邮件地址
  • CONFLUENCE_TOKEN:您的Atlassian API代币

许可证

内部Adform工具。