项目简介
该项目是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在连接AI模型(如大型语言模型LLM)与 Metricool 平台。通过这个服务器,AI客户端能够以结构化的方式调用 Metricool API,获取社交媒体和广告账户的数据,并执行诸如发布帖子等操作。
主要功能点
该服务器通过MCP协议提供了以下与 Metricool 交互的能力:
- 获取社交媒体数据: 检索来自 Instagram (Reels, Posts, Stories)、TikTok (Videos)、Facebook (Reels, Posts, Stories)、Threads (Posts)、X/Twitter (Posts)、Bluesky (Posts)、LinkedIn (Posts)、Pinterest (Pins)、YouTube (Videos)、Twitch (Videos) 等平台的数据。
- 获取广告活动数据: 检索 Facebook Ads, Google Ads, TikTok Ads 的广告活动信息。
- 获取品牌信息与竞争对手: 查询Metricool账户下的品牌列表及竞争对手信息。
- 帖子排期: 安排帖子在指定日期和时间发布到已连接的社交媒体账户。
- 获取最佳发布时间: 查询特定社交媒体平台的最佳发布日期和时间建议。
- 更新已排期帖子: 修改已经安排好的帖子详情。
安装步骤
- 确保您已安装 Python 3.8 或更高版本。
- 安装 'uv',一个快速的 Python 包安装和环境管理工具。请参考 uv 官方文档 进行安装。
- 克隆本 GitHub 仓库到您的本地计算机。
- 拥有一个 Metricool 账户(需要高级套餐以获得 API 访问权限)以及您的 Metricool API Token 和 User ID。
- 安装支持 MCP 的客户端,例如 Claude Desktop 或 Cursor。
服务器配置
MCP 服务器由 MCP 客户端启动和管理。您需要在您的 MCP 客户端中配置此服务器的启动方式。以 Claude Desktop 为例,您需要编辑其配置文件 'claude_desktop_config.json' (macOS: '~/Library/Application Support/Claude/claude_desktop_config.json', Windows: '%APPDATA%/Claude/claude_desktop_config.json')。
在配置文件的 'mcpServers' 部分添加一个条目来描述此 Metricool MCP 服务器,指定如何启动它以及传递哪些必要信息。
- 指定一个服务器名称(例如:"mcp-metricool")。
- 设置 'command' 字段为服务器启动命令的可执行路径,通常是 'uvx'。
- 设置 'args' 字段为一个列表,包含传递给 'command' 的参数。对于此项目,参数是 'mcp-metricool'。
- 设置 'env' 字段为一个对象,包含服务器运行所需的环境变量。此服务器需要 'METRICOOL_USER_TOKEN'(您的 Metricool API 密钥)和 'METRICOOL_USER_ID'(您的 Metricool 用户 ID)。您需要在 'env' 对象中设置这两个键值对,并替换为您自己的实际密钥和 ID。
请根据您的 MCP 客户端文档找到正确的配置位置和格式,并填入上述信息和您的 Metricool 凭据。
基本使用方法
- 完成安装和服务器配置步骤,确保已正确填入您的 Metricool API 凭据。
- 启动您的 MCP 客户端(例如 Claude Desktop)。客户端将根据配置自动启动或按需启动 Metricool MCP 服务器。
- 在客户端中与LLM交互。LLM应能发现并利用 Metricool MCP 服务器提供的工具能力。您可以通过自然语言向LLM提出请求,例如“获取我的 Instagram 数据”、“安排一篇 Facebook 帖子”等。LLM会通过 MCP 协议调用 Metricool MCP 服务器上的相应工具来完成任务。
信息
分类
商业系统