maximoseo/kw-research-mcp
GitHub: maximoseo/kw-research-mcp
这是一个MCP服务器，用于将AI智能体连接到关键词研究工具，实现自动化研究管理和数据查询。
Stars: 0 | Forks: 0
# 关键词研究 MCP 服务器
这是一个 MCP (模型上下文协议) 服务器，它通过 Supabase 将 [关键词研究](https://kw-research.onrender.com) 仪表板连接到像 **Claude Desktop** 和 **Manus AI** 这样的 AI 智能体。
## 概述
此服务器公开了 8 个工具，允许 AI 智能体与关键词研究平台交互：
| 工具 | 描述 |
|------|------|
| `list-projects` | 列出所有研究项目 |
| `get-project` | 获取项目的详细信息 |
| `list-research-runs` | 列出一个项目的研究运行 |
| `get-research-run` | 获取包含所有日志的单个研究运行 |
| `get-research-file` | 获取输出文件的预签名下载链接 |
| `get-keyword-data` | 查询 SERP 关键词结果 |
| `create-project` | 创建一个新的研究项目 |
| `get-project-stats` | 获取项目的聚合统计数据 |
## 安装
```
cd /root/hermes-projects/kw-research-mcp
npm install
npm run build
```
## 使用
### 直接运行
```
node dist/index.js
```
### 通过 npx 运行
```
npx kw-research-mcp
```
### 配置 Claude Desktop
将以下内容添加到你的 `claude_desktop_config.json`：
```
{
"mcpServers": {
"kw-research": {
"command": "node",
"args": ["/root/hermes-projects/kw-research-mcp/dist/index.js"],
"env": {
"SUPABASE_URL": "https://wtpczvyupmavzrxisvcm.supabase.co",
"SUPABASE_SERVICE_ROLE_KEY": "your-service-role-key"
}
}
}
}
```
### 配置 Manus AI
配置你的 Manus AI 工作区以指向 MCP 服务器的 stdio 端点。
## 环境变量
| 变量 | 描述 | 默认值 |
|------|------|--------|
| `SUPABASE_URL` | Supabase 项目 URL | `https://wtpczvyupmavzrxisvcm.supabase.co` |
| `SUPABASE_SERVICE_ROLE_KEY` | Supabase 服务角色密钥 | 内置默认值 |
## 数据库模式
此服务器连接到以下 Supabase 表（全部位于 `public` 模式中）：
- `users` — 用户账户
- `projects` — 研究项目
- `research_runs` — 单次研究执行运行
- `research_logs` — 运行日志和进度
- `serp_results` — SERP 关键词排名数据
- `content_map`, `content_briefs`, `search_cache`, `uploaded_files`, `sessions` — 支持性表
### 存储桶
- `research-reports` — 私有报告文件
- `research-workbooks` — 私有工作簿文件
- `research-uploads` — 私有上传文件
## 开发
```
# 安装 dependencies
npm install
# 编译 TypeScript
npm run build
# 以开发模式运行
npm run dev
```
标签：AI代理集成, API服务器, Linux 内核安全, MCP协议, MITM代理, Node.js应用, PPID欺骗, SEO工具, SERP分析, Supabase数据库, 云服务, 代理工具, 关键词研究, 工具开发, 搜索优化, 数据仪表板, 数据库连接, 数据查询, 文件下载, 环境配置, 统计分析, 自动化攻击, 软件包管理, 项目管理