Search Stock News MCP

🚀 Stock News Search MCP Server

The Stock News Search MCP Server is a powerful tool that enables seamless interaction between AI systems and stock news data sources, providing real - time news search and customizable query options.

⚠️ Important Note

The Stock News Search MCP Server is compatible with Cline, Cursor, Claude Desktop, and any other MCP clients! It can seamlessly connect to any MCP client.

The Model Context Protocol (MCP) is an open standard that allows AI systems to interact with their data sources and tools, enabling secure two - way connections.

The Stock News Search MCP Server offers the following features:

• Real - time stock news search via the Tavily API
• Multiple customizable search query templates
• Configurable search parameters and filtering options
• Domain - specific content filtering
• Type - safe operations using TypeScript

🚀 Quick Start

Prerequisites 🔧

Before you start, make sure you have the following:

• A Tavily API key
• Claude Desktop, Cursor, or any MCP - compatible client
• Node.js (version v16 or higher)
• Git installed (only required for the Git installation method)

Installation ⚡

Run with NPX

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

Install via Smithery

To automatically install the Stock News Search MCP Server for Claude Desktop:

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

Configuration ⚙️

Configure Cline 🤖

The easiest way to set up the Stock News Search MCP Server in Cline is through the marketplace:

1. Open Cline in VS Code.
2. Click the Cline icon in the left sidebar.
3. Go to the "MCP Servers" tab.
4. Search for "Stock News" and click "Install".
5. When prompted, enter your Tavily API key.

Alternatively, manually configure the server in Cline:

1. Open the config/clair.json file.
2. Add the following content to the end of the file:

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

3. Save the file and restart Cline.

Configure Cursor 🔍

To set up the Stock News Search MCP Server in Cursor:

1. Open the config/cursor.json file.
2. Add the following content to the end of the file:

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

3. Save the file and restart Cursor.

Configure Claude Desktop 👨💻

To set up the Stock News Search MCP Server in Claude Desktop:

1. Open the config/claude.json file.
2. Add the following content to the end of the file:

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

3. Save the file and restart Claude Desktop.

💻 Usage Examples

Basic Usage

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

Advanced Usage

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"}'

Custom Domain Search

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"}'

🔧 Troubleshooting

Common Issues

1. Server not found

   • Check if the npm installation is correct.
   • Verify the syntax of the configuration file.
   • Ensure that Node.js is installed correctly.

2. API key issues

   • Validate the effectiveness of the Tavily API key.
   • Check if the key is correctly set in the configuration.
   • Make sure there are no spaces or quotes in the key.

3. Search result issues

   • Check if the search parameters are within the valid range.
   • Validate if the domain filter is correctly formatted.
   • Ensure the company names and stock codes are accurate.

✨ Acknowledgments

• Model Context Protocol for the MCP specification
• Anthropic for Claude Desktop
• Tavily for the news search API

📄 License

MIT