⭐️ GPlay 评论 MCP 服务器

一个用于访问和分析 Google Play 商店评论的模型上下文协议 (MCP) 服务器。由 Kir Gor (2025) 开发。

🚀 功能

• 评分过滤: 按星级评分、日期范围等查询评论
• 高级搜索: 查找包含特定关键字或短语的评论
• 回复管理: 发布和跟踪对用户反馈的回复
• 自动分析: 生成关于评论情感和趋势的见解
• 语言支持: 按语言和地区过滤评论
• 设备分析: 了解用户按设备类型和操作系统版本划分的问题
• 集成就绪: 与 Claude 和其他 MCP 客户端无缝协作
• 完全类型安全: 完全类型化的 TypeScript 代码库，带有接口

📋 要求

• Node.js 18+
• Google Play Developer API 凭据
• 一个 MCP 客户端（如 Claude AI）

🔧 安装

克隆仓库

git clone https://github.com/Kirill812/GPlay_reviews_MCP_server.git
cd GPlay_reviews_MCP_server

安装依赖

npm install

Google Play API 设置

1. 在 Google Cloud Console 中创建一个服务帐户
2. 启用 Google Play Developer API
3. 生成并下载您的凭据
4. 将您的服务帐户链接到您的 Google Play Developer 帐户

配置

1. 基于示例创建一个 .env 文件：

cp .env.example .env

2. 在 .env 中设置您的 Google Play API 凭据的路径：

GOOGLE_PLAY_CREDENTIALS_PATH=/path/to/your/credentials.json
LOG_LEVEL=info
STORAGE_DIR=data
USE_MOCK_DATA=false

🚀 使用

启动服务器

# 构建 TypeScript 代码
npm run build

# 启动服务器
npm start

对于具有自动重新加载的开发：

npm run dev

MCP 集成

将此配置添加到您的 Claude 或其他 MCP 客户端：

{
  "mcpServers": {
    "GPlay Reviews": {
      "command": "node",
      "args": ["/path/to/GPlay_reviews_MCP_server/dist/index.js"],
      "env": {
        "GOOGLE_PLAY_CREDENTIALS_PATH": "/path/to/credentials.json",
        "LOG_LEVEL": "info",
        "STORAGE_DIR": "data",
        "USE_MOCK_DATA": "false"
      },
      "disabled": false,
      "autoApprove": [
        "get_reviews",
        "search_reviews",
        "post_reply"
      ]
    }
  }
}

📝 API 文档

MCP 工具

get_reviews

检索特定应用程序的评论，具有全面的过滤选项。

// 示例：获取过去一周的 5 星评论
{
  "appPackage": "com.example.app",
  "filter": {
    "minRating": 5,
    "maxRating": 5,
    "startDate": "2025-03-15T00:00:00Z",
    "limit": 20
  }
}

// 示例：获取所有英文的 1 星评论
{
  "appPackage": "com.example.app",
  "filter": {
    "minRating": 1,
    "maxRating": 1,
    "languages": ["en"],
    "limit": 50
  }
}

search_reviews

搜索包含特定文本的评论，可以跨所有应用程序或在特定应用程序中搜索。

// 示例：搜索提及 "crash" 的评论
{
  "query": "crash",
  "appPackage": "com.example.app", // 可选
  "limit": 20
}

// 示例：查找关于电池问题的评论
{
  "query": "battery drain",
  "filter": {
    "minRating": 1,
    "maxRating": 3
  }
}

post_reply

回复特定评论。

{
  "reviewId": "abc123xyz",
  "replyText": "感谢您的反馈！我们正在调查此问题，并将在下一次更新中修复。"
}

MCP 资源

• googleplay://apps - 列出所有可访问的应用程序
• googleplay://reviews/{appPackage} - 获取特定应用程序的评论
• googleplay://reviews/{appPackage}/{reviewId} - 获取特定评论的详细信息
• googleplay://stats/{appPackage} - 获取应用程序的评论统计信息

🧪 开发

项目结构

/
├── src/                  # 源代码
│   ├── repositories/     # 数据访问层
│   ├── utils/            # 实用函数
│   ├── types.ts          # TypeScript 类型定义
│   └── index.ts          # 服务器入口点
├── data/                 # JSON 文件存储（在运行时创建）
├── scripts/              # 辅助脚本
├── tests/                # 测试文件
└── dist/                 # 编译后的 JavaScript（在构建时创建）

测试

npm test

代码检查

npm run lint
npm run lint:fix

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

1. Fork 该项目
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到该分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

📄 许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

👤 作者

由 Kir Gor (2025) 创建

---

<p align="center">用 ❤️ 为模型上下文协议生态系统制作</p>