desearch-mcp-server 0.0.1 → 0.1.2

package/build/index.js

@@ -1,124 +1,30 @@
 #!/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");
+import { startHttpServer } from "./http.js";
+import { createDesearchMcpServer } from "./server.js";
+function wantsHttp() {
+    return process.argv.includes("--http") || process.env.MCP_TRANSPORT === "http";
 }
-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),
-                },
-            ],
-        };
+async function main() {
+    if (wantsHttp()) {
+        const port = Number(process.env.PORT ?? "3000");
+        if (!Number.isInteger(port) || port < 0 || port > 65535) {
+            throw new Error("PORT must be an integer between 0 and 65535");
+        }
+        const host = process.env.HOST ?? "0.0.0.0";
+        await startHttpServer({ port, host });
+        return;
     }
-    catch (error) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `X Search error: ${error instanceof Error ? error.message : String(error)}`,
-                },
-            ],
-            isError: true,
-        };
+    const apiKey = process.env.DESEARCH_API_KEY;
+    if (!apiKey) {
+        throw new Error("DESEARCH_API_KEY environment variable is required");
     }
+    const server = createDesearchMcpServer(apiKey);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Desearch server is running...");
+}
+main().catch((error) => {
+    console.error(`Server error: ${error instanceof Error ? error.message : String(error)}`);
+    process.exit(1);
 });
-(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/build/server.d.ts

@@ -0,0 +1,103 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const SERVER_NAME = "Desearch";
+export declare const SERVER_VERSION = "0.1.2";
+interface XSearchPayload {
+    query: string;
+    sort?: "Top" | "Latest";
+    count?: number;
+    user?: string;
+    start_date?: string;
+    end_date?: string;
+    lang?: string;
+    verified?: boolean;
+    blue_verified?: boolean;
+    is_quote?: boolean;
+    is_video?: boolean;
+    is_image?: boolean;
+    min_retweets?: number | string;
+    min_replies?: number | string;
+    min_likes?: number | string;
+}
+interface PageContentPayload {
+    url: string;
+    format?: "html" | "text";
+    js?: boolean;
+    wait?: number;
+}
+interface DesearchClient {
+    aiSearch(payload: Record<string, unknown>): Promise<unknown>;
+    xSearch(payload: XSearchPayload): Promise<unknown>;
+    webSearch(payload: {
+        query: string;
+        start?: number;
+    }): Promise<unknown>;
+    aiWebLinksSearch(payload: {
+        prompt: string;
+        tools: string[];
+        count?: number;
+    }): Promise<unknown>;
+    aiXLinksSearch(payload: {
+        prompt: string;
+        count?: number;
+    }): Promise<unknown>;
+    xPostsByUrls(payload: {
+        urls: string[];
+    }): Promise<unknown>;
+    xPostById(payload: {
+        id: string;
+    }): Promise<unknown>;
+    xPostsByUser(payload: {
+        user: string;
+        query?: string;
+        count?: number;
+    }): Promise<unknown>;
+    xPostRetweeters(payload: {
+        id: string;
+        cursor?: string;
+    }): Promise<unknown>;
+    xUserPosts(payload: {
+        username: string;
+        cursor?: string;
+    }): Promise<unknown>;
+    xUserReplies(payload: {
+        user: string;
+        count?: number;
+        query?: string;
+    }): Promise<unknown>;
+    xPostReplies(payload: {
+        post_id: string;
+        count?: number;
+        query?: string;
+    }): Promise<unknown>;
+    xTrends(payload: {
+        woeid: number;
+        count?: number;
+    }): Promise<unknown>;
+    extract(payload: PageContentPayload): Promise<unknown>;
+    webCrawl(payload: PageContentPayload): Promise<unknown>;
+}
+/**
+ * Payload note when a link search body has no link list.
+ * Does not name web vs AI search, and does not say the query had "results".
+ * A missing list (the cost-only API bug) and an empty list are the same note:
+ * this response body does not contain links.
+ */
+export declare const NO_LINKS_MESSAGE = "no links in response";
+/**
+ * Pass a link payload through when it contains at least one link.
+ * A cost-only body (billing fields, no link list) and an empty link list
+ * both get `message: "no links in response"` plus the original fields,
+ * including billing. The note does not claim the search returned results
+ * and does not name which search tool produced the body.
+ */
+export declare function presentSearchBody(value: unknown): unknown;
+/**
+ * One MCP server bound to a single Desearch API key.
+ * Stdio uses the process env key. Remote HTTP builds a new server per request
+ * so each caller spends their own key.
+ * `client` is a test seam. Production callers omit it and the server builds
+ * a desearch-js client from `apiKey`.
+ */
+export declare function createDesearchMcpServer(apiKey: string, client?: DesearchClient): McpServer;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/build/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../server.ts"],"names":[],"mappings":"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"}