Provides tools for managing WeChat Official Accounts, enabling capabilities such as creating and listing drafts, uploading images, and publishing articles.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@WeChat Official Account MCP Serverlist my recent WeChat drafts"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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环境变量
变量 | 说明 |
| 微信公众号AppID |
| 微信公众号AppSecret |
| Token缓存目录 (默认: ~/.cache/wechat-mcp) |
使用
运行微信公众号服务器
python -m mcp4agent --app wechat运行 Docker 监控服务器
python -m mcp4agent --app dockerDocker 监控使用
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环境变量
变量 | 说明 | 必填 |
| 微信公众号AppID | 是 |
| 微信公众号AppSecret | 是 |
| 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 有安全风险,仅在可信环境中使用。
健康检查
服务运行在 8080 端口,MCP 客户端可连接进行健康检查。
更新日志
v0.3.0
重构为多包架构 (mcp4agent)
分离 wechat_mcp 和 docker_status 为独立包
添加 BuildKit 缓存优化 Docker 构建
支持多平台构建
v0.2.0
迁移到 FastMCP 框架
添加 Docker 容器监控功能
简化工具定义和使用
This server cannot be installed
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.