Advocu MCP服务器
用于向Advocu平台提交活动的模型上下文协议（MCP）服务器。
支持
如果你觉得这个项目有用，请考虑通过以下方式支持我的工作 🙏
跟我来
扫描下面的二维码访问我的网站并关注我的工作：
安装
npm install发展
npm run dev构建
npm run build
npm start可用工具
MCP服务器公开了以下用于提交活动的工具：
1.提交反馈会话
提交反馈会议活动。
必填字段：
activityDate（字符串，格式：YYYY-MM-DD）dockerRepresentative（字符串，3-100个字符）modeOfCommunication（枚举：“船长简报会”、“直接通话”、“Slack”、“其他”）metrics.timeSpent（整数，最小值1）title（字符串，3-200个字符）description（字符串，最多2000个字符）
可选字段：
private（布尔值）
2.提交_资源
提交资源活动。
必填字段：
title（字符串，3-200个字符）description（字符串，最多2000个字符）activityDate（字符串，格式：YYYY-MM-DD）metrics.views（整数，最小值1）contentType（枚举：博客文章、时事通讯、社交媒体帖子、代码示例、草图、书籍或电子书、视频、文档、开源库、用例、其他）
可选字段：
tags（字符串数组）activityUrl（字符串，最多500个字符，必须是有效的URL）additionalInfo（字符串，最多2000个字符）private（布尔值）
3.提交_公开_表达
提交公开演讲活动。
必填字段：
title（字符串，3-200个字符）description（字符串，最多2000个字符）activityDate（字符串，格式：YYYY-MM-DD）format（枚举：“面对面活动”、“虚拟活动”、”录制视频“、”直播视频“）duration（整数，至少1分钟）metrics.attendees（整数，最小值1）
可选字段：
tags（字符串数组）activityUrl（字符串，最多500个字符，必须是有效的URL）additionalInfo（字符串，最多2000个字符）private（布尔值）
4.提交_事件
提交活动。
必填字段：
title（字符串，3-200个字符）description（字符串，最多2000个字符）dates.start（字符串，格式：YYYY-MM-DD）dates.end（字符串，格式：YYYY-MM-DD）type（枚举：黑客马拉松、聚会、学习堵塞、研讨会、培训、演讲会、网络会议、会议、贸易展览、其他）format（枚举：“面对面”、“虚拟”、“混合”）duration（枚举：“全天活动”、“半天活动”、”多日活动“、”晚间活动“、“其他”）metrics.attendees（整数，最小值1）
可选字段：
tags（字符串数组）activityUrl（字符串，最多500个字符，必须是有效的URL）additionalInfo（字符串，最多2000个字符）private（布尔值）
5.提交放大
提交扩增活动。
必填字段：
activityDate（字符串，格式：YYYY-MM-DD）metrics.views（整数，最小值1）title（字符串，3-200个字符）description（字符串，最多2000个字符）type（数组，1-3个项目来自：“转发”、“评论参与”、“其他”）channel（数组，1-4个项目来自：“HackerNews”、“社交媒体”、“自有频道”、“其他”）
可选字段：
url（字符串，最多100个字符）private（布尔值）
6.刮擦含量
从URL（YouTube视频、文章或任何链接）中抓取内容以提取元数据。
必填字段：
url（字符串，必须是有效的HTTP/HTTPS URL）
退货： 从URL提取的元数据，包括：
- 对于YouTube视频：
title,description,viewCount,channelName,publishDate,uploadDate,thumbnailUrl,videoId - 对于文章/网站：
title,description,publishDate,author,siteName,imageUrl,contentType
此工具使用 curl 从Open Graph标签、元标签、JSON-LD结构化数据和平台特定格式（例如YouTube的嵌入式数据）中获取HTML内容并解析元数据。
用法
此服务器设计用于MCP客户端。有几种方法可以使用它：
选项1：与代理配置一起使用（推荐）
对于像Cagent/Cline这样的代理框架，您可以使用提供的代理配置文件。看 advocu_activity_agent.yaml 举一个完整的例子。
此代理配置：
- 自动从您的描述中检测活动类型
- 提取并推断日期、标题、描述和指标
- 使用scrape_content工具使用curl从URL（博客文章、YouTube视频等）中提取元数据
- 帮助智能地完成所有必填字段
设置：
- 复制
advocu_activity_agent.yaml到您的代理配置目录 - 设置
ADVOCU_API_KEY环境变量：
export ADVOCU_API_KEY="your-api-key-here"- 确保Docker正在运行（基于Docker的MCP服务器需要）
- 代理将通过Docker自动使用MCP服务器
代理使用示例：
只需自然地描述你的活动，代理就会处理其余的事情：
- “我昨天在博客上发表了一篇关于Docker的文章https://example.com/docker-blog"
- “我上周在DockerCon上做了一次演讲，45分钟，200名与会者，虚拟活动”
- “今天我通过Slack与Docker的John进行了30分钟的反馈会议”
代理将自动：
- 检测活动类型
- 使用scrape_content工具（基于curl）从URL中提取信息
- 填写必填字段
- 询问任何缺失的信息
选项2：直接MCP客户端配置
对于传统的MCP客户端，请将以下内容添加到您的MCP客户端配置中：
{
"mcpServers": {
"advocu": {
"command": "node",
"args": ["path/to/advocu-mcp/dist/index.js"],
"env": {
"ADVOCU_API_KEY": "your-api-key-here",
"ADVOCU_API_URL": "https://api.advocu.com"
}
}
}
}选项3：基于Docker的使用
您也可以直接通过Docker运行MCP服务器（如代理配置所示）：
docker run -i --rm -e ADVOCU_API_KEY=your-api-key-here sarthaksavvy/advocu-mcp-server:latest认证
服务器支持通过环境变量进行API密钥身份验证：
ADVOCU_API_KEY：用于身份验证的Advocu API密钥ADVOCU_API_URL：Advocu API的基本URL（默认为https://api.advocu.com)
这些可以在您的环境中设置，也可以在MCP客户端配置中设置，如下例所示。
许可证
麻省理工学院