AppBot MCP服务器
一种模型上下文协议（MCP）服务器，提供与AppBot API交互的工具。该服务器使AI助手能够检索应用程序信息、搜索应用程序、获取评论、分析应用程序数据并生成全面的报告。
特性
- 应用信息检索：获取有关特定应用程序的详细信息，包括元数据、评级和统计数据
- 应用程序搜索：搜索带有过滤器和分页的应用程序
- 评审管理：使用情绪分析检索和分析应用评论
- 分析集成：访问应用程序性能指标和分析数据
- 报告生成：创建包含竞争分析的综合报告
可用工具
get_app_info
检索特定应用程序的详细信息。
参数：
appId（string，必填）：应用程序的唯一标识符
search_apps
根据查询和可选过滤器搜索应用程序。
参数：
query（字符串，必填）：应用程序搜索查询category（字符串，可选）：类别筛选器limit（数字，可选）：返回的最大结果数（默认值：10）
get_app_reviews
通过可选筛选获取特定应用程序的评论。
参数：
appId（string，必填）：应用程序的唯一标识符limit（数字，可选）：最多可返回评论数（默认值：10）rating（数字，可选）：按等级筛选（1-5颗星）
get_app_analytics
检索特定应用程序的分析数据。
参数：
appId（string，必填）：应用程序的唯一标识符startDate（字符串，可选）：分析的开始日期（YYYY-MM-DD）endDate（字符串，可选）：分析结束日期（YYYY-MM-DD）metrics（数组，可选）：要检索的特定指标
create_app_report
为应用程序创建全面的报告。
参数：
appId（string，必填）：应用程序的唯一标识符reportType（字符串，必填）：报告类型（“摘要”、“详细”、“竞争性”）includeReviews（布尔值，可选）：在报告中包含评论（默认值：true）includeAnalytics（布尔值，可选）：在报告中包含分析（默认值：true）
安装
- 克隆存储库：
git clone
cd AppBotMcp- 安装依赖项：
npm install- 创建环境配置：
cp .env.example .env- 编辑
.env使用您的AppBot API凭据：
APPBOT_API_BASE_URL=https://api.appbot.com
APPBOT_API_KEY=your_api_key_here
APPBOT_API_VERSION=v1发展
VS代码设置（推荐）
有关最佳开发体验，请参阅 VS代码设置指南.
快速启动：
# Open in VS Code
code appbot-mcp.code-workspace
# Or open folder
code /path/to/AppBotMcp使用VS代码命令面板(Cmd+Shift+P)用于“AppBot构建”、“AppBot开发”等任务。
命令行开发
构建项目：
npm run build在开发模式下运行：
npm run dev以手表模式运行：
npm run watch运行测试：
npm test配置
可以使用环境变量配置服务器：
APPBOT_API_BASE_URL：AppBot API的基本URLAPPBOT_API_KEY：用于身份验证的API密钥APPBOT_API_VERSION：要使用的API版本（默认值：v1）MCP_SERVER_NAME：MCP服务器的名称MCP_SERVER_VERSION：MCP服务器的版本RATE_LIMIT_REQUESTS_PER_MINUTE：速率限制（默认值：60）LOG_LEVEL：日志记录级别（错误、警告、信息、调试）
与MCP客户端一起使用
此服务器实现了模型上下文协议，可以与任何兼容MCP的客户端一起使用。服务器通过stdio传输进行通信。
VS代码开发设置
1.在VS Code中打开
code /path/to/AppBotMcp2.安装推荐的扩展
VS Code将提示安装推荐的扩展，或手动安装：
- TypeScript和JavaScript语言特性
- Pretier-代码格式化程序
- JSON语言特性
3.开发任务
使用 Cmd+Shift+P （macOS）或 Ctrl+Shift+P （Windows/Linux）访问VS Code任务：
- AppBot-构建：将TypeScript编译为JavaScript
- AppBot-开发：以热重载的开发模式运行
- AppBot-测试：运行测试套件
- AppBot-测试观察：在监视模式下运行测试
- AppBot-健康检查：测试API连接
- AppBot MCP-测试连接：测试MCP协议通信
4.配置文件
该项目包括VS代码配置：
.vscode/settings.json：编辑器和TypeScript设置.vscode/tasks.json：构建和测试任务.vscode/mcp-config.json：MCP服务器配置模板
5.测试MCP服务器
运行MCP测试任务以验证服务器是否响应协议消息：
# Via VS Code Command Palette
Tasks: Run Task → AppBot MCP - Test Connection
# Or directly in terminal
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | node dist/index.jsClaude桌面集成
macOS配置
地点： ~/Library/Application Support/Claude/claude_desktop_config.json
Windows配置
地点： %APPDATA%/Claude/claude_desktop_config.json
配置内容
{
"mcpServers": {
"appbot": {
"command": "node",
"args": ["/absolute/path/to/AppBotMcp/dist/index.js"],
"env": {
"APPBOT_API_KEY": "your_api_key_here",
"APPBOT_API_BASE_URL": "https://api.appbot.com"
}
}
}
}其他MCP客户端
该服务器可以与任何支持stdio传输的MCP客户端一起使用。有关集成说明，请参阅客户的文档。
API要求
此服务器需要通过以下端点访问AppBot API：
GET /apps/{id}-获取应用程序信息GET /apps/search-搜索应用程序GET /apps/{id}/reviews-获取应用评论GET /apps/{id}/analytics-获取应用分析POST /apps/{id}/report-创建应用报告GET /health-健康检查
错误处理
服务器包括全面的错误处理和日志记录。记录所有API错误，并向MCP客户端返回适当的错误响应。
速率限制
客户端包括自动速率限制以遵守API配额。默认速率限制为每分钟60个请求，可以通过环境变量进行配置。
许可证
麻省理工学院
支持
有关问题和疑问，请参阅存储库的问题跟踪器。