使用说明
📈 模型上下文协议（MCP）代理应用程序
一个基于TypeScript的Ai代理，集成了MCP。该项目提供了一个统一的接口，通过MCP服务器和工具调用访问金融市场信息和相关新闻文章。
演示
终端
https://github.com/user-attachments/assets/47150b98-0663-43f6-927e-f09abb796fe6
光标
https://github.com/user-attachments/assets/72210b49-dc23-4bef-b7ee-6d289ede59e1
✨ 特性
- 📊 股市数据:
- 公司信息
- 季度财务状况
- 年度财务报告
- 📰 新闻整合:
- 实时新闻文章
- 基于查询的新闻搜索
- 🛠️ 架构组件:
- 客户端-服务器体系结构
- TypeScript实现
- 模块化设计模式
- 朗链代理
🔧 先决条件
- Node.js 16.x或更高版本
- TypeScript 4.x或更高版本
- 股票服务和OpenAi的API密钥
🚀 快速开始
1.安装
克隆并设置项目：
git clone https://github.com/extrawest/financial-ai-agent-mcp-servers
cd financial-ai-agent-mcp-servers
# Install dependencies
npm install
2.环境配置
创建一个 .env 项目根目录中的文件：
# API Configuration
STOCK_API_KEY=your_stock_api_key
OPENAI_API_KEY=your_open_ai_key
3.构建和运行
# Build the project
npm run build
# Start the server
npm start
🏗️ 项目结构
src/
├── agent/
│ └── agent.ts # Agent implementation
├── client/
│ └── client.ts # API client implementation
├── config/
│ └── configs.ts # Configuration management
├── logger/
│ └── logger.ts # Logging functionality
├── server/
│ ├── news-server.ts # News API server
│ └── stocks-server.ts # Stock market API server
├── types/
│ └── newsapi.d.ts # Type definitions
└── index.ts # Application entry point
📦 核心组件
股票服务器
处理所有与股票市场相关的操作：
- 公司信息检索
- 财务报告访问
- 市场数据处理
新闻服务器
管理新闻相关功能：
- 文章搜索和检索
- 查询处理
- 新闻数据格式
客户端
提供与两台服务器交互的统一界面：
- API请求处理
- 响应处理
- 错误管理
启动应用程序
在单独的终端选项卡中运行
# Start Stocks server
npm run stocks:built
# Start News server
npm npm run news:built
# Run agent
npm run agent:built
将mcp添加到游标IDE
- 打开光标IDE，转到设置->光标设置
- 转到“工具和集成”部分
- 找到MCP工具，单击新建MCP服务器
- 将其添加到mcp.json文件中
{
"mcpServers": {
"stocks-mcp-server": {
"url": "http://127.0.0.1:3000/sse"
},
"news-mcp-server": {
"url": "http://127.0.0.1:3001/sse"
}
}
}
- 在单独的终端选项卡中运行命令
# Start Stocks server
npm run stocks:built
# Start News server
npm npm run news:built
📝 许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
由Oleksandr Samoilenko创建
Extrawest.com, 2025
