desearch-mcp-server 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Desearch AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,134 @@
+# Desearch MCP Server
+
+[![npm version](https://badge.fury.io/js/desearch-mcp-server.svg)](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
+```
+
+## 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"
+    ```

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":""}

package/build/index.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import Desearch from "desearch-js";
+const server = new McpServer({
+    name: "Desearch",
+    version: "0.0.1",
+});
+const DESEARCH_API_KEY = process.env.DESEARCH_API_KEY;
+if (!DESEARCH_API_KEY) {
+    throw new Error("DESEARCH_API_KEY environment variable is required");
+}
+const desearch = new Desearch(DESEARCH_API_KEY);
+server.tool("ai-search", "Real-time AI search and analysis on web using Desearch AI", {
+    prompt: z.string().describe("Question, example: 'What is the latest news on AI?'"),
+    tools: z
+        .array(z.enum([
+        "Twitter Search",
+        "Web Search",
+        "ArXiv Search",
+        "Wikipedia Search",
+        "Youtube Search",
+        "Hacker News Search",
+        "Reddit Search",
+    ]))
+        .optional()
+        .default(["Twitter Search", "Web Search"])
+        .describe("Tools to use for the search, example: ['Web Search', 'Twitter Search']"),
+    date_filter: z
+        .enum([
+        "PAST_24_HOURS",
+        "PAST_2_DAYS",
+        "PAST_WEEK",
+        "PAST_2_WEEKS",
+        "PAST_MONTH",
+        "PAST_2_MONTHS",
+        "PAST_YEAR",
+        "PAST_2_YEARS",
+    ])
+        .optional()
+        .describe("Time range for the search, example: 'PAST_WEEK'"),
+    model: z
+        .enum(["NOVA", "ORBIT"])
+        .default("NOVA")
+        .describe("Model to use for the search, example: 'NOVA', Nova is 10s model, Orbit is 30s model"),
+}, async ({ prompt, tools, date_filter, model }) => {
+    try {
+        const aiResult = await desearch.AISearch({
+            prompt,
+            tools,
+            date_filter,
+            model,
+            streaming: false,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(aiResult, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `X Search error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+server.tool("x-search", "Search the X (Twitter) using Desearch AI - performs real-time tweet search on X.", {
+    query: z
+        .string()
+        .describe("Twitter advanced search query, example: 'from:elonmusk since:2023-01-01 min_replies:10'"),
+    count: z
+        .number()
+        .optional()
+        .default(20)
+        .describe("Number of search results to return (default: 20), max is 100"),
+}, async ({ query, count }) => {
+    try {
+        const twitterResult = await desearch.twitterSearch({
+            query,
+            sort: "Top",
+            count,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(twitterResult, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `X Search error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+(async () => {
+    try {
+        // Start receiving messages on stdin and sending messages on stdout
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+    }
+    catch (error) {
+        console.log(`Server error: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+})();

package/package.json

@@ -0,0 +1,44 @@
+{
+    "name": "desearch-mcp-server",
+    "version": "0.0.1",
+    "description": "A Model Context Protocol server with Desearch for real-time AI search, X search and web search.",
+    "type": "module",
+    "author": "Desearch AI",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/Desearch-ai/mcp-desearch.git"
+    },
+    "bin": {
+        "desearch-mcp-server": "./build/index.js"
+    },
+    "files": [
+        "build"
+    ],
+    "keywords": [
+        "desearch",
+        "mcp",
+        "model context protocol",
+        "ai",
+        "twitter",
+        "websearch",
+        "claude"
+    ],
+    "scripts": {
+        "build": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"",
+        "inspector": "npx @modelcontextprotocol/inspector build/index.js",
+        "prepare": "npm run build",
+        "prepublishOnly": "npm run build"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.11.3",
+        "desearch-js": "^1.0.1",
+        "zod": "^3.24.4"
+    },
+    "devDependencies": {
+        "@types/node": "^20.14.8",
+        "typescript": "^5.8.3"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    }
+}