Medium MCP API Server

基本能力

产品定位

Medium MCP API Server 是一个专门为Medium平台设计的内容发布和管理服务，通过MCP协议实现AI模型与Medium API的交互。

核心功能

• 认证与用户管理
• 安全的Medium OAuth集成
• 基于JWT的认证

• 用户配置文件管理

• 内容发布

• 支持Markdown和HTML内容格式
• 草稿创建和管理
• 文章调度发布
• 出版物集成

• 标签和分类支持

• 媒体管理

• 图片上传和存储

• 内容格式化工具

• 可靠性与性能

• 基于Redis的缓存
• 文章发布的作业调度
• 全面的错误处理
• 速率限制

适用场景

• 自动化内容发布和管理
• AI生成内容的直接发布到Medium
• 多用户的内容协作平台
• 定时发布内容

工具列表

• Docker：用于容器化部署，简化环境配置和依赖管理。
• Node.js：服务器运行环境。
• MongoDB：数据存储。
• Redis：用于缓存和作业调度（可选但推荐）。

常见问题解答

• 如何获取Medium API凭证？ 需要在Medium开发者平台创建应用并获取Client ID和Client Secret。
• 如何配置定时发布？ 需要配置Redis并设置scheduledAt字段。
• 如何确保安全性？ 使用HTTPS、定期更换JWT密钥、实施适当的CORS策略。

使用教程

使用依赖

• Node.js 16+
• MongoDB
• Redis（可选，推荐用于调度）
• Medium API凭证

安装教程

使用Docker（推荐）

1. 克隆仓库： bash git clone https://github.com/jignesh88/medium-mcp-api.git cd medium-mcp-api
2. 创建.env文件： bash cp .env.example .env
3. 更新.env文件： MEDIUM_CLIENT_ID=your_medium_client_id MEDIUM_CLIENT_SECRET=your_medium_client_secret MEDIUM_REDIRECT_URI=http://your-domain.com/api/auth/medium/callback JWT_SECRET=your_strong_secret_key
4. 启动服务： bash docker-compose up -d

手动安装

1. 克隆仓库： bash git clone https://github.com/jignesh88/medium-mcp-api.git cd medium-mcp-api
2. 安装依赖： bash npm install
3. 配置.env文件
4. 启动MongoDB和Redis
5. 启动应用： bash npm start

调试方式

• 检查服务是否运行： bash curl http://localhost:3000/api/health
• 测试认证端点： bash curl -X POST http://localhost:3000/api/auth/register -H "Content-Type: application/json" -d '{"email":"[email protected]","name":"Test User"}'
• 测试内容发布： bash curl -X POST http://localhost:3000/api/posts -H "Authorization: Bearer your_jwt_token" -H "Content-Type: application/json" -d '{"title":"Test Post","content":"Test content","contentFormat":"markdown"}'

许可证

该项目遵循 MIT 开源许可条款。