Parse.ly MCP服务器
模型上下文协议（MCP）服务器，提供对Parse.ly分析API的访问。该服务器使Claude等人工智能助手能够查询Parse.ly数据，以进行内容分析、引用、搜索和社交分享。
内置于 克劳德代码 -请参阅 CLAUDE.md 为发展提供指导。
特性
- 双重运输：支持两个stdio（用于
npx使用）和流式HTTP传输 - 分析工具：通过基于日期的查询获取热门帖子、作者和标签的指标
- 推荐人数据：按类型（社交、搜索、其他、内部）跟踪流量来源
- 内容搜索：搜索Parse.ly内容
- 社会股份：查看跨平台的共享计数
- 日期范围支持：查询特定日期或范围以进行基于时间的比较
- 类型安全：使用TypeScript构建以提高可靠性
- 测试良好：具有模拟API响应的综合单元测试
- Docker支持：易于集装箱化部署，港口暴露
先决条件
- Node.js>=20.0.0
- 解析.ly API凭据（API密钥和机密）
- 从获取您的凭据https://dash.parse.ly/
安装
npx快速入门
使用此服务器的最简单方法是通过 npx。将其添加到MCP客户端配置中：
{
"mcpServers": {
"parsely": {
"command": "npx",
"args": ["parsely-mcp"],
"env": {
"PARSELY_API_KEY": "your_api_key_here",
"PARSELY_API_SECRET": "your_api_secret_here"
}
}
}
}这使用stdio传输，这是默认的，适用于Claude Desktop、Claude Code和其他MCP客户端。
本地开发
- 克隆存储库：
git clone https://github.com/dailybeast/parsely-mcp.git
cd parsely-mcp- 安装依赖项：
npm install- 创建一个
.env示例中的文件：
cp .env.example .env- 编辑
.env并添加您的Parse.ly凭据：
PARSELY_API_KEY=your_api_key_here
PARSELY_API_SECRET=your_api_secret_here
PORT=8742- 构建项目：
npm run build- 运行服务器：
# Stdio transport (default)
npm start
# HTTP transport
node dist/index.js --http使用时 --http，服务器启动于 http://localhost:8742 与：
- MCP端点:
http://localhost:8742/mcp-流式HTTP传输（POST、GET、DELETE） - 健康检查:
http://localhost:8742/health-服务器运行状况
码头工人
- 构建Docker镜像：
docker build -t parsely-mcp .- 使用环境变量运行容器：
docker run -e PARSELY_API_KEY=your_key -e PARSELY_API_SECRET=your_secret -p 8742:8742 parsely-mcp可用工具
MCP服务器公开了以下工具：
get_analytics_posts
获取热门帖子的分析数据。
- 参数：
days（数字，默认值：7），limit（数字，默认值：10），sort（字符串，可选）
get_analytics_authors
获取顶级作者的分析数据。
- 参数：
days（数字，默认值：7），limit（数字，默认值：10）
get_analytics_tags
获取顶级标签的分析数据。
- 参数：
days（数字，默认值：7），limit（数字，默认值：10）
get_referrers
获取显示流量来源的推荐人数据。
- 参数：
days（数字，默认值：7），limit（数字，默认值：10），type（字符串，可选：“社交”、“搜索”等）
search_content
搜索Parse.ly内容。
- 参数：
query（字符串，必填），limit（数字，默认值：10）
get_shares
获取帖子的社交分享数据。
- 参数：
days（数字，默认值：7），limit（数字，默认值：10）
发展
可用脚本
npm run build # Compile TypeScript
npm run dev # Watch mode for development
npm run lint # Run ESLint
npm test # Run tests
npm run test:watch # Run tests in watch mode
npm run test:coverage # Generate coverage report运行测试
测试使用模拟的Parse.ly API响应，不需要真正的证书：
npm test对于需要环境变量的测试：
PARSELY_API_KEY=test PARSELY_API_SECRET=test npm test配置
所有配置都是通过环境变量完成的：
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
PARSELY_API_KEY | 是 | - | 您的Parse.ly API密钥 |
PARSELY_API_SECRET | 是 | - | 您的Parse.ly API机密 |
PARSELY_API_BASE_URL | 没有 | https://api.parse.ly/v2 | 解析.ly API基础URL |
PORT | 没有 | 8742 | 服务器端口（仅限HTTP模式） |
API文档
有关Parse.ly API的更多信息：
贡献
欢迎投稿！请确保：
- 所有测试均通过(
npm test) - 代码已过梁(
npm run lint) - TypeScript编译时没有错误(
npm run build)
许可证
MIT许可证-请参阅 许可证 详见
支持
对于问题和疑问：
- GitHub问题：https://github.com/dailybeast/parsely-mcp/issues
- Parse.ly文档：https://docs.parse.ly/
致谢
- 内置于 克劳德代码 -人工智能辅助开发
- 模型上下文协议SDK -MCP的TypeScript SDK
- 解析.ly API -内容分析平台
发展
此项目使用 CLAUDE.md AI辅助开发指导。该文件包含：
- 架构概述和代码组织
- 常见开发命令
- 测试要求和惯例
- 开源最佳实践