JinDaGe - search-stock-news-mcp MCP Details

article

README

🚀 股票新闻搜索MCP服务器

股票新闻搜索MCP服务器可无缝连接到任何MCP客户端，与Cline、Cursor、Claude Desktop以及其他MCP客户端兼容。它基于模型上下文协议（MCP）这一开放标准构建，能让AI系统与其数据源和工具进行交互，实现安全的双向连接。

✨ 主要特性

通过Tavily API实现实时股票新闻搜索。
提供多个可自定义的搜索查询模板。
具备可配置的搜索参数和过滤选项。
支持领域特定内容过滤。
使用TypeScript进行类型安全操作。

📦 安装指南

先决条件 🔧

在开始安装之前，请确保你具备以下条件：

Tavily API密钥。
Claude Desktop、Cursor或任何MCP兼容客户端。
Node.js（v16及以上版本）。
Git已安装（仅适用于Git安装方法）。

安装方式

使用NPX运行

npx -y search-stock-news-mcp@latest

通过Smithery安装

要自动为Claude Desktop安装股票新闻搜索MCP服务器，可使用以下命令：

npx -y @smithery/cli install search-stock-news-mcp --client claude

⚙️ 配置MCP客户端

配置Cline 🤖

在Cline中设置股票新闻搜索MCP服务器，最简单的方法是通过市场进行操作：

打开Cline的VS Code。
点击左侧边栏中的Cline图标。
转到“MCP服务器”选项卡。
搜索“股票新闻”并点击“安装”。
出现提示时，输入你的Tavily API密钥。

若要手动配置Cline中的服务器，可按以下步骤操作：

打开config/clair.json文件。
在文件末尾添加以下内容：

{
  "stockNewsMCP": {
    "enabled": true,
    "apiKey": "your-tavily-api-key",
    "searchEndpoint": "https://api.tavily.com/v1/search"
  }
}

保存文件并重启Cline。

配置Cursor 🔍

在Cursor中设置股票新闻搜索MCP服务器，可按以下步骤操作：

打开config/cursor.json文件。
在文件末尾添加以下内容：

{
  "stockNewsSearch": {
    "enabled": true,
    "apiEndpoint": "https://api.tavily.com/v1/stock-news",
    "apiKey": "your-tavily-api-key"
  }
}

保存文件并重启Cursor。

配置Claude Desktop 👨💻

在Claude Desktop中设置股票新闻搜索MCP服务器，可按以下步骤操作：

打开config/claude.json文件。
在文件末尾添加以下内容：

{
  "newsSearch": {
    "enabled": true,
    "mcpEndpoint": "http://localhost:3000",
    "apiKey": "your-tavily-api-key"
  }
}

保存文件并重启Claude Desktop。

💻 使用示例

基础用法

curl -X POST http://localhost:3000/api/search \
  -H "Content-Type: application/json" \
  -d '{"query":"latest stock news","pageSize":10}'

高级用法

curl -X POST http://localhost:3000/api/advanced-search \
  -H "Content-Type: application/json" \
  -d '{"keywords":["AI","finance"],"sortBy":"relevance","startDate":"2023-10-01","endDate":"2023-10-31"}'

自定义域名搜索

curl -X POST http://localhost:3000/api/custom-domain-search \
  -H "Content-Type: application/json" \
  -d '{"domains":["www.bloomberg.com","www.reuters.com"],"query":"market trends"}'

🔧 故障排除

常见问题及解决办法

服务器未找到
- 检查npm安装是否正确。
- 查看配置文件语法是否正确。
- 确保Node.js已正确安装。
API密钥问题
- 验证Tavily API密钥的有效性。
- 检查密钥是否在配置中正确设置。
- 确保密钥没有空格或引号。
搜索结果问题
- 检查搜索参数是否在有效范围内。
- 验证域名过滤器是否正确格式化。
- 确保公司名称和股票代码准确无误。

✨ 致谢

Model Context Protocol提供MCP规范。
Anthropic提供Claude Desktop。
Tavily提供新闻搜索API。

📄 许可证

本项目采用MIT许可证。

search-stock-news-mcp