tweetsave-mcp
使用说明（Markdown 格式）
-
项目简介
- 这是一个基于 MCP 的后台服务器，核心职责是以标准化的 JSON-RPC 形式向大模型客户端提供上下文信息和功能。它托管与管理“资源/数据、工具和提示模板”等能力，能够读取推文数据、处理线程、生成博客格式内容，并通过多种传输方式对外暴露。
-
主要功能点
- 提供推文读取与处理工具（单条推文、线程）。
- 将推文转换为博客文章格式，支持 Markdown 与 JSON 输出。
- 批量读取、媒体提取、参与度统计等辅助工具。
- 多传输通道支持：stdio、SSE（服务器发送事件，适用于远程客户端）、REST HTTP（直接 API 访问）。
- 通过 MCP 服务器进行会话管理、工具注册与调用。
-
安装步骤
- 需要环境: Node.js。推荐版本 14+（实际需求以仓库依赖为准）。
- 克隆仓库后，在项目根目录执行安装依赖：
- npm install
- 运行方式（两种传输模式任选其一）：
- stdio 传输：直接在支持 MCP 的环境中启动，服务器会通过标准输入输出与客户端通信。
- 启动方式（同生成的可执行入口，一般为编译后的 JS/TS 入口，示例环境可用 ts-node 或预编译版本运行）：运行包含 src/index.ts 的入口文件。
- HTTP 传输（对外暴露 REST/SSE 接口 + MCP 远程连接支持）：
- 启动命令将启动一个 HTTP 服务器，默认端口为 3000；若需要修改端口，请设置环境变量 PORT。
- 运行入口通常对应 http-server 入口文件。
- stdio 传输：直接在支持 MCP 的环境中启动，服务器会通过标准输入输出与客户端通信。
-
服务器配置（MCP 客户端需要的启动信息） 说明：MCP 客户端需要一个服务器描述，包含服务器名称、启动命令及参数等，以便与服务器建立连接。以下为基于本仓库实现的可用配置示例。请根据实际部署调整命令与端口等参数。
{ "server_name": "tweetsave-mcp-server", "command": ["node", "dist/http-server.js"], "args": [] }
注释：
- server_name：唯一标识服务器的名称，建议与实际部署名称保持一致，便于在 MCP 客户端管理。
- command：启动服务器的命令数组，第一项为可执行程序，后续为参数。若使用本地打包的 HTTP 服务器，常见为 ["node", "dist/http-server.js"]。
- args：传给启动命令的附加参数（本实现中一般为空，端口通过环境变量 PORT 控制，默认 3000）。
- 端口说明：HTTP 传输默认监听 3000 端口，可通过设置环境变量 PORT 来调整端口，例如 PORT=8080。若使用 stdio 模式，则不需要该端口设置。
-
基本使用方法
- 通过 MCP 客户端连接：
- 使用上述配置启动服务器。
- 客户端将通过 MCP 协议向服务器发送请求，读取推文、获取线程、将推文转为博客等。
- 常见操作示例（由 MCP 客户端触发）：
- Get Tweet：读取单条推文及其元数据。
- Get Thread：获取某条推文所在的线程（若可用）。
- Convert to Blog：将推文转为博客格式（Markdown / JSON）。
- Batch Fetch：一次请求多条推文。
- Extract Media：提取推文中的媒体链接等。
- 运行后可以通过 MCP 客户端的标准调用方式与之交互，具体工具将返回文本内容或 JSON 数据，以及可能的错误信息。
- 通过 MCP 客户端连接：