MCP

🚀 PostCrawl MCP 服务器

PostCrawl MCP 服务器是一个基于 Cloudflare Workers 的模型上下文协议（MCP）服务器，它提供了对 PostCrawl API 的访问，可用于在社交媒体平台（尤其是 Reddit）上搜索和提取内容。

🚀 快速开始

前提条件

• Node.js（最新的 LTS 版本）
• Bun（推荐）或 npm
• 一个 Cloudflare 账户（用于部署）
• PostCrawl API 密钥
• MCP Inspector（用于测试）

安装

1. 安装依赖项：

npm install

2. 启动开发服务器：

bun dev

3. 服务器将在 http://localhost:8787 上可用

使用 MCP Inspector 进行测试

测试此 MCP 服务器的最简单方法是使用 MCP Inspector。

📖 请参阅 how-to-use.md 以获取带截图的详细分步说明。

快速概览：

1. 安装 MCP Inspector：npx @modelcontextprotocol/inspector
2. 使用 "Streamable HTTP" 传输类型
3. 连接到：https://postcrawl.com/mcp
4. 添加带有 PostCrawl API 密钥的授权标头
5. 测试可用工具

✨ 主要特性

PostCrawl 是一项 API 服务，允许你在社交媒体平台上搜索帖子并提取其内容。此 MCP 服务器为 PostCrawl API 提供了无缝接口，使 AI 助手能够：

• 使用可自定义参数搜索帖子
• 从特定 URL 提取内容
• 以 Markdown 格式检索帖子
• 使用简化的布尔参数控制提取深度
• 检查 API 健康状态

📚 详细文档

身份验证

服务器需要将 PostCrawl API 密钥作为承载令牌提供：

Authorization: Bearer YOUR_POSTCRAWL_API_KEY

可用的 MCP 工具

1. search

在社交媒体平台上搜索帖子。

参数：

• query（字符串，必需）：搜索查询
• page（整数，可选）：页码（默认值：1）
• results（整数，可选）：结果数量（默认值：10）
• social_platforms（字符串数组，可选）：要搜索的社交媒体平台

2. search_and_extract

在一次操作中搜索帖子并提取其内容。

与 search 的参数相同，另外还有：

• response_mode（字符串，可选）：响应格式 - "raw" 或 "markdown"（默认值："raw"）
• include_comments（布尔值，可选）：包括评论和回复（默认值：false）

3. extract

从特定 URL 提取内容。

参数：

• urls（字符串数组，必需）：要从中提取内容的 URL 列表
• include_comments（布尔值，可选）：包括评论和回复（默认值：false）
• response_mode（字符串，可选）：响应格式 - "raw" 或 "markdown"（默认值："raw"）

4. check_health

检查 PostCrawl API 的健康状态。

参数： 无

开发脚本

• bun dev 或 npm run dev - 启动开发服务器
• npm run deploy - 部署到 Cloudflare Workers
• npm run type-check - 运行 TypeScript 类型检查
• npm run cf-typegen - 生成 Cloudflare Worker 类型

部署

部署到 Cloudflare Workers：

npm run deploy

配置

PostCrawl API 配置：

速率限制

速率限制取决于你的 PostCrawl API 计划。服务器包含了对速率限制响应的适当错误处理。

架构

• Hono：用于 Cloudflare Workers 的 Web 框架
• agents/mcp：MCP 代理框架
• @modelcontextprotocol/sdk：MCP 协议实现
• zod：运行时类型验证
• PostCrawl API：社交媒体内容提取服务

错误处理

服务器为以下情况提供了全面的错误处理：

• 缺少或无效的身份验证
• PostCrawl API 错误
• 无效的请求参数
• 网络超时

📄 许可证

本项目采用 ISC 许可证。