内容
# AI News Collector MCP
一个基于AI的新闻事件智能采集与分析系统，支持MCP (Model Context Protocol) 协议。
## 🚀 快速开始
### 前置要求
- Node.js 18+
- Docker & Docker Compose
- Git
### 1. 克隆项目
```bash
git clone <repository-url>
cd ai-news-collector-mcp
```
### 2. 初始化环境
```bash
# Linux/macOS
./deploy.sh setup
# Windows
deploy.bat setup
```
### 3. 配置环境变量
```bash
cp .env.example .env
# 编辑 .env 文件，配置必要的参数
```
### 4. 启动服务
```bash
# 启动基础服务
./deploy.sh start default
# 启动包含监控的服务
./deploy.sh start monitoring
# 启动所有服务
./deploy.sh start all
```
### 5. 验证部署
```bash
# 健康检查
./deploy.sh health
# 查看服务状态
./deploy.sh status
```
## 📋 服务端点
### API服务 (http://localhost:3001)
- `GET /health` - 健康检查
- `POST /api/test` - 测试接口
- `GET /api/test-data` - 生成测试数据
- `GET /api/system/info` - 系统信息
### MCP服务器
系统包含基础的MCP服务器，提供以下工具：
- `test_function` - 简单测试函数
- `health_check` - 健康检查
- `generate_test_data` - 生成测试数据
## 🔧 开发
### 安装依赖
```bash
npm install
```
### 开发模式
```bash
# 启动API服务器
npm run api-server
# 启动MCP服务器
npm run mcp-server
# 启动主应用
npm run dev
```
### 运行测试
```bash
npm test
npm run test:watch
```
### 构建项目
```bash
npm run build
```
## 🐳 Docker部署
### 支持的服务组合
- `default` - 主应用 + Redis
- `mcp` - 包含MCP服务器
- `monitoring` - 包含Prometheus + Grafana
- `all` - 所有服务
### 常用命令
```bash
# 启动服务
./deploy.sh start [service]
# 停止服务
./deploy.sh stop [service]
# 重启服务
./deploy.sh restart [service]
# 查看日志
./deploy.sh logs [service]
# 创建备份
./deploy.sh backup
# 清理数据
./deploy.sh cleanup
```
## 📊 监控
### Prometheus
- 地址: http://localhost:9090
- 配置文件: `monitoring/prometheus.yml`
### Grafana
- 地址: http://localhost:3002
- 默认用户: admin
- 默认密码: admin
## 🔍 测试
系统包含完整的测试套件：
- 单元测试
- 集成测试
- API测试
运行测试：
```bash
# 运行所有测试
npm test
# 运行测试并生成覆盖率报告
npm run test:coverage
# 监视模式运行测试
npm run test:watch
```
## 📁 项目结构
```
ai-news-collector-mcp/
├── src/ # 源代码
│ ├── api/ # API服务
│ ├── mcp/ # MCP服务器
│ ├── models/ # 数据模型
│ ├── config/ # 配置管理
│ ├── types/ # 类型定义
│ ├── utils/ # 工具函数
│ └── index.ts # 主入口
├── tests/ # 测试文件
├── data/ # 数据存储
├── logs/ # 日志文件
├── monitoring/ # 监控配置
├── docker-compose.yml # Docker编排
├── deploy.sh # 部署脚本 (Linux/macOS)
├── deploy.bat # 部署脚本 (Windows)
└── README.md # 项目说明
```
## ⚙️ 配置
### 环境变量
主要配置项：
- `RSSHUB_URL` - RSSHub服务地址
- `REDIS_HOST` - Redis主机地址
- `PYTHON_SERVICE_URL` - Python服务地址
- `OPENAI_API_KEY` - OpenAI API密钥
### 外部服务集成
- **RSSHub**: 默认使用 http://124.221.80.250:5678
- **Redis**: 支持外部Redis服务器配置
- **Python服务**: 支持外部Python分析服务集成
## 🛠️ 开发计划
### 当前阶段
- ✅ 基础框架搭建
- ✅ 简单测试模块
- ✅ MCP服务器
- ✅ API服务
- ✅ Docker部署
- 🔄 监控系统
### 下一阶段
- 📋 数据采集模块
- 📋 存储与缓存
- 📋 Python分析服务
- 📋 高级功能模块
## 🤝 贡献
欢迎提交Issue和Pull Request！
## 📄 许可证
MIT License
MCP 市场