项目简介

该项目是一个基于 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账户下的品牌列表及竞争对手信息。
  • 帖子排期: 安排帖子在指定日期和时间发布到已连接的社交媒体账户。
  • 获取最佳发布时间: 查询特定社交媒体平台的最佳发布日期和时间建议。
  • 更新已排期帖子: 修改已经安排好的帖子详情。

安装步骤

  1. 确保您已安装 Python 3.8 或更高版本。
  2. 安装 'uv',一个快速的 Python 包安装和环境管理工具。请参考 uv 官方文档 进行安装。
  3. 克隆本 GitHub 仓库到您的本地计算机。
  4. 拥有一个 Metricool 账户(需要高级套餐以获得 API 访问权限)以及您的 Metricool API Token 和 User ID。
  5. 安装支持 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 凭据。

基本使用方法

  1. 完成安装和服务器配置步骤,确保已正确填入您的 Metricool API 凭据。
  2. 启动您的 MCP 客户端(例如 Claude Desktop)。客户端将根据配置自动启动或按需启动 Metricool MCP 服务器。
  3. 在客户端中与LLM交互。LLM应能发现并利用 Metricool MCP 服务器提供的工具能力。您可以通过自然语言向LLM提出请求,例如“获取我的 Instagram 数据”、“安排一篇 Facebook 帖子”等。LLM会通过 MCP 协议调用 Metricool MCP 服务器上的相应工具来完成任务。

信息

分类

商业系统