Social Media MCP

面向社交媒体渠道的本地 MCP adapter 集合。当前已提供抖音通道，MCP Client 通过 stdio 调用 douyin.* tools，完成通道启动、登录辅助、消息和通知操作。

云端沙箱、浏览器登录态、消息缓存和资源释放由 channel-server 管理；本仓库只包含用户本地运行的 MCP adapter。

当前支持

渠道	Adapter 路径	MCP tools
抖音	mcp_data/mcp_adapter.py	douyin.*

更多渠道会以独立 adapter 的形式加入本仓库。

前置条件

• Python 3.10 或更高版本
• Git
• 已在控制台创建的 API Key
• 控制台提供的 channel-server 地址

安装

git clone https://github.com/wjy19812408234/social_meadia_mcp.git social-media-mcp
cd social-media-mcp
python3 --version
# 确认输出为 Python 3.10 或更高版本
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -r requirements.txt

Windows PowerShell：

git clone https://github.com/wjy19812408234/social_meadia_mcp.git social-media-mcp
cd social-media-mcp
py -3 --version
# 确认输出为 Python 3.10 或更高版本
py -3 -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -r requirements.txt

配置 MCP Client

将下列内容添加到 AI Client 的 MCP 配置中，并替换路径、服务地址和 API Key。

macOS / Linux：

{
  "mcpServers": {
    "byering-social-media-mcp": {
      "command": "/absolute/path/social-media-mcp/.venv/bin/python",
      "args": [
        "/absolute/path/social-media-mcp/mcp_data/mcp_adapter.py",
        "--channel-server-url", "https://yydsagent.com:8800",
        "--api-key", "byk_xxx"
      ]
    }
  }
}

Windows：

{
  "mcpServers": {
    "byering-social-media-mcp": {
      "command": "C:\\path\\to\\social-media-mcp\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\path\\to\\social-media-mcp\\mcp_data\\mcp_adapter.py",
        "--channel-server-url", "https://yydsagent.com:8800",
        "--api-key", "byk_xxx"
      ]
    }
  }
}

--channel-server-url 填服务基础地址，不要附加 /v1；adapter 会自行拼接 API 路径。--session-id 可选，不传时 adapter 会使用 API Key 自动创建或绑定会话。

本地验证

激活虚拟环境后，可以先在终端启动 adapter：

python -m mcp_data.mcp_adapter \
  --channel-server-url https://yydsagent.com:8800 \
  --api-key byk_xxx

也可以使用交互式 REPL 检查工具是否可用：

python -m mcp_data.mcp_client_repl \
  --channel-server-url https://yydsagent.com:8800 \
  --api-key byk_xxx

进入 mcp> 后输入 tools 查看已注册工具。工具说明可在 MCP Client 中通过 tools 命令查看。

安全说明

• API Key 只放在本地 MCP Client 配置或本地环境变量中，不要提交到 Git。
• mcp_data/runtime/ 是本地运行数据，不应提交。
• 退订会释放云端沙箱并清理抖音登录态；调用 douyin.unsubscribe 前必须向用户二次确认。