README.md•3.89 kB
# Desearch MCP Server
[](https://www.npmjs.com/package/desearch-mcp-server)
A Model Context Protocol (MCP) server lets clients like Claude or Cursor use the Desearch AI for real-time AI X search and web search.
## Tools
The Desearch MCP server includes the following tools:
- **AI Search**: Performs real-time AI Twitter and web searches with relevant links and summary.
- **X Search**: Real-time tweet search on X.
## Prerequisites 📋
- An [Desearch API Key](https://console.desearch.ai/api-keys)
- [Node.js](https://nodejs.org/) (v18 or higher)
- [Claude Desktop](https://claude.ai/download) installed
- [Cursor IDE](https://www.cursor.com/)
## Installation 🛠️
### NPM Installation
```bash
npm install -g desearch-mcp-server
```
### Using Smithery
To install the Desearch MCP server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@Desearch-ai/desearch):
```bash
npx -y @smithery/cli install @Desearch-ai/desearch --client claude
```
Or for Cursor IDE:
```bash
npx -y @smithery/cli install @Desearch-ai/desearch --client cursor
```
## Configuration ⚙️
### 1. Configure Cursor IDE to run the Desearch MCP server
Open Cursor IDE, access command palette `Cmd+Shift+P` or `Ctrl+Shift+P`, and search for `Open MCP Settings`. Click on `Add new global MCP server` to open the `mcp.json` file.
### 2. Add the Desearch server configuration:
```json
{
"mcpServers": {
"desearch": {
"command": "desearch-mcp-server",
"env": {
"DESEARCH_API_KEY": "your-api-key"
}
}
}
}
```
Replace `your-api-key` with your actual Desearch API key from [console.desearch.ai/api-keys](https://console.desearch.ai/api-keys).
### 3. Restart Cursor IDE
For the changes to take effect:
1. Completely quit Cursor IDE
2. Start Cursor IDE again
### 1. Configure Claude Desktop to run the Desearch MCP server
Open the Claude Desktop app and enable Developer Mode from the top-left menu bar.
Once enabled, open Settings (also from the top-left menu bar) and navigate to the Developer Option, where you'll find the Edit Config button. Clicking it will open the `claude_desktop_config.json` file, allowing you to make the necessary edits.
OR (if you want to open `claude_desktop_config.json` from terminal)
#### For macOS:
1. Open your Claude Desktop config:
```bash
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```
#### For Windows:
1. Open your Claude Desktop configuration:
```powershell
code %APPDATA%\Claude\claude_desktop_config.json
```
### 2. Add the Desearch server configuration:
```json
{
"mcpServers": {
"desearch": {
"command": "desearch-mcp-server",
"env": {
"DESEARCH_API_KEY": "your-api-key"
}
}
}
}
```
Replace `your-api-key` with your actual Desearch API key from [console.desearch.ai/api-keys](https://console.desearch.ai/api-keys).
### 3. Restart Claude Desktop
For the changes to take effect:
1. Completely quit Claude Desktop
2. Start Claude Desktop again
3. You can verify the server by checking status in Settings > Developer > desearch
## Troubleshooting 🔧
### Common Issues
1. **Server Not Found**
- Check Claude or Cursor Desktop configuration syntax
- Ensure Node.js is installed
2. **API Key Issues**
- Confirm your `DESEARCH_API_KEY` is valid
- Check the `DESEARCH_API_KEY` is correctly set in the Cursor or Claude Desktop config
- Verify that there are no spaces around the API key
3. **Connection Issues**
- Restart Claude Desktop or Cursor IDE completely
- Check Claude Desktop logs:
```bash
# macOS
tail -n 50 -f ~/Library/Logs/Claude/mcp*.log
# Windows
type "%APPDATA%\Claude\logs\mcp*.log"
```