使用说明
项目简介
Medium MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,它允许大型语言模型 (LLM) 客户端通过标准化的 MCP 协议,与 Medium 内容平台进行交互。该服务器提供了一系列工具,使 LLM 能够执行如发布文章、检索用户文章、搜索 Medium 内容等操作,从而实现 AI 驱动的内容工作流自动化。
主要功能点
- 文章发布工具: 允许 LLM 客户端通过调用 'publish-article' 工具,在 Medium 平台上发布新的文章,支持设置标题、内容、标签和发布到指定 Publication。
- 用户 Publication 获取工具: 通过 'get-publications' 工具,LLM 客户端可以获取用户的 Medium Publication 列表,方便内容发布和管理。
- 文章搜索工具: 'search-articles' 工具支持 LLM 客户端根据关键词、Publication ID 和标签搜索 Medium 平台上的文章,实现内容发现和检索。
安装步骤
- 克隆仓库
git clone https://github.com/Dishant27/medium-mcp-server.git cd medium-mcp-server - 安装依赖
确保已安装 Node.js (v16 或更高版本) 和 npm 或 yarn。
npm install - 配置环境变量
创建 '.env' 文件,并填入 Medium API 凭据。您需要在 Medium 开发者平台获取 'MEDIUM_CLIENT_ID' 和 'MEDIUM_CLIENT_SECRET'。
MEDIUM_CLIENT_ID=您的 Medium Client ID MEDIUM_CLIENT_SECRET=您的 Medium Client Secret
服务器配置
MCP 客户端需要配置以下信息以连接到 Medium MCP Server。请注意,这里的配置是 JSON 格式,用于 MCP 客户端,不是直接在服务器上操作的。
{ "serverName": "medium-mcp-server", "command": "node", "args": ["dist/index.js"] }
配置参数说明:
- 'serverName': 服务器名称,设置为 "medium-mcp-server"。
- 'command': 启动服务器的命令,这里使用 'node',假设您已全局安装 Node.js。
- 'args': 传递给 'node' 命令的参数,'dist/index.js' 是编译后的服务器入口文件。您可能需要先执行 'npm run build' 来生成 'dist/index.js' 文件 (仓库中未提供 build 命令,但根据 TypeScript 项目的常见实践,可能需要编译)。
请注意: 仓库中 'package.json' 文件缺失,没有 'build' 和 'start' 脚本。实际部署前,您可能需要自行添加构建和启动脚本,例如:
"scripts": { "build": "tsc", "start": "node dist/index.js" }
并确保先运行 'npm run build' 生成 'dist/index.js',再使用上述配置启动服务器。
基本使用方法
-
启动服务器 在项目根目录下,运行以下命令启动 Medium MCP Server (假设您已添加 'start' 脚本并构建了项目):
npm start服务器成功启动后,您应该能在控制台看到 '🚀 MediumMCP Server Initialized' 的提示信息。
-
配置 MCP 客户端 在您的 MCP 客户端应用中,根据上述 “服务器配置” 部分提供的 JSON 配置信息,配置连接到 Medium MCP Server。
-
通过 MCP 客户端调用工具 使用 MCP 客户端,您可以调用 Medium MCP Server 提供的工具,例如:
- 调用 'publish-article' 工具发布文章。
- 调用 'get-publications' 工具获取用户 Publication 列表。
- 调用 'search-articles' 工具搜索 Medium 文章。
具体的工具调用方法和参数,请参考 MCP 客户端的文档和 Medium MCP Server 代码中 'src/index.ts' 文件内 'registerTools' 方法的工具定义。
例如,使用 MCP 客户端调用 'publish-article' 工具的请求可能如下 (JSON-RPC 格式,仅为示例):
{ "jsonrpc": "2.0", "method": "call", "params": { "tool_name": "publish-article", "arguments": { "title": "My Test Article", "content": "This is the content of my test article.", "tags": ["test", "article"] } }, "id": 1 }
请根据实际需求和工具定义,构建您的 MCP 客户端请求。
信息
分类
生产力应用