MCP 服务器

WeChat Official Account MCP Server

Enables management of WeChat Official Accounts by supporting draft creation, image uploads, and content publishing via the MCP protocol. It provides tools for interacting with the WeChat API, including secure token caching and draft list management.

README

MCP4Agent - 多功能MCP服务器

微信公众号管理工具，支持文章发布、草稿管理等功能。同时提供 Docker 容器监控功能。

项目结构

mcp4agent/
├── src/
│   ├── wechat_mcp/          # 微信公众号 MCP 包
│   │   ├── __init__.py
│   │   ├── server.py        # FastMCP 服务器和工具
│   │   ├── api.py           # 微信 API 封装
│   │   ├── config.py        # 配置管理
│   │   └── token_cache.py   # Token 缓存
│   ├── docker_status/       # Docker 监控 MCP 包
│   │   ├── __init__.py
│   │   └── server.py        # Docker 工具
│   ├── __init__.py          # 导出两个 MCP 应用
│   └── __main__.py          # 入口点
├── tests/
├── Dockerfile               # 优化构建（BuildKit 缓存）
├── docker-compose.yml
├── pyproject.toml           # 多包配置
└── README.md

功能特性

📝 微信公众号工具

create_draft - 创建草稿
upload_image - 上传图片
list_drafts - 列出草稿
publish_draft - 发布草稿（需要权限）

🐳 Docker 监控工具

list_containers - 列出所有容器及状态
get_container_stats - 查看容器资源使用（CPU/内存/网络）
get_container_logs - 获取容器日志
restart_container - 重启容器

安装

pip install -e .

配置

复制 .env.example 为 .env，填入你的配置：

cp .env.example .env

环境变量

变量	说明
`WECHAT_APP_ID`	微信公众号AppID
`WECHAT_APP_SECRET`	微信公众号AppSecret
`WECHAT_TOKEN_CACHE_DIR`	Token缓存目录 (默认: ~/.cache/wechat-mcp)

使用

运行微信公众号服务器

python -m mcp4agent --app wechat

运行 Docker 监控服务器

python -m mcp4agent --app docker

Docker 监控使用

Docker 工具通过 Python docker 库连接 Docker 守护进程：

# 列出所有运行中的容器
list_containers()

# 列出所有容器（包括已停止的）
list_containers(all_containers=True)

# 查看容器资源使用
get_container_stats("container_id_or_name")

# 获取容器日志
get_container_logs("container_id_or_name", lines=100)

# 重启容器
restart_container("container_id_or_name")

权限要求

使用 Docker 功能需要：

运行 MCP 服务器的用户有权限访问 Docker socket
通常需要将用户加入 docker 组：
```
sudo usermod -aG docker $USER
```

Token缓存

使用 diskcache 实现本地缓存，避免频繁请求access_token。

from wechat_mcp.token_cache import TokenCache

cache = TokenCache()
token = cache.get_access_token(app_id, app_secret)

Docker 部署

构建镜像

DOCKER_BUILDKIT=1 docker build -t mcp4agent .

使用 Docker Compose（推荐）

# 复制环境变量模板
cp .env.example .env

# 编辑 .env 填入你的配置
nano .env

# 启动服务
docker-compose up -d

使用 Docker Run

docker run -d \
  --name mcp4agent \
  -p 8080:8080 \
  -e WECHAT_APP_ID=your_app_id \
  -e WECHAT_APP_SECRET=your_app_secret \
  -v $(pwd)/data:/app/.cache \
  mcp4agent

环境变量

变量	说明	必填
`WECHAT_APP_ID`	微信公众号AppID	是
`WECHAT_APP_SECRET`	微信公众号AppSecret	是
`WECHAT_TOKEN_CACHE_DIR`	Token缓存目录	否 (默认: /app/.cache)

Docker in Docker 监控

要在容器内监控其他容器，需要挂载 Docker socket：

docker run -d \
  --name mcp4agent \
  -p 8080:8080 \
  -e WECHAT_APP_ID=your_app_id \
  -e WECHAT_APP_SECRET=your_app_secret \
  -v $(pwd)/data:/app/.cache \
  -v /var/run/docker.sock:/var/run/docker.sock \
  mcp4agent

⚠️ 注意: 挂载 Docker socket 有安全风险，仅在可信环境中使用。