Files
agent/mcp/web-search-free/mcp.js
T

96 lines
3.3 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* MCP(Model Context Protocol)协议层:工具清单 + JSON-RPC 分发。
*
* 与传输无关(stdio / HTTP 都在 server.js 里),只负责把一条 JSON-RPC
* 消息变成 JSON-RPC 响应。支持的 method 与上游 dsh-web-search-free 一致:
* initialize / tools/list / tools/call / ping。
*/
import { parallelSearch, exaSearch } from './core.js';
export const SERVER_NAME = 'dsh-web-search-free';
export const VERSION = '1.0.0';
const DEFAULT_PROTOCOL = '2025-03-26';
/** 暴露给 MCP 客户端的工具清单。 */
const TOOLS = [
{
name: 'web_search',
description: 'Free web search tool. Uses Parallel by default or Exa as fallback. Returns an array of results with title, url, snippet, and publishedAt.',
inputSchema: {
type: 'object',
properties: {
query: { type: 'string', description: 'Search query text' },
provider: { type: 'string', enum: ['parallel', 'exa'], description: "Backend provider: 'parallel' (default) or 'exa' (fallback)" },
numResults: { type: 'integer', minimum: 1, default: 8, description: 'Maximum number of results to return (default 8)' },
},
required: ['query'],
},
},
];
/** 执行一次 tools/call;失败时抛 { code, message } 表示工具级错误。 */
async function callTool(name, args) {
if (name !== 'web_search') throw { code: -32602, message: `unknown tool: ${name}` };
const params = args ?? {};
const query = typeof params.query === 'string' && params.query.trim().length > 0
? params.query.trim()
: null;
if (query === null) throw { code: -32602, message: 'query is required' };
const provider = params.provider === 'exa' ? 'exa' : 'parallel';
const numResults = typeof params.numResults === 'number' && Number.isFinite(params.numResults)
? Math.max(1, Math.floor(params.numResults))
: 8;
const sources = provider === 'exa'
? await exaSearch(query, numResults, process.env.EXA_API_KEY)
: await parallelSearch(query, numResults);
return { content: [{ type: 'text', text: JSON.stringify(sources, null, 2) }] };
}
/** 处理一条请求消息,返回 result;失败时抛 { code, message }。 */
async function handleRequest(message) {
switch (message.method) {
case 'initialize':
return {
protocolVersion: message.params?.protocolVersion ?? DEFAULT_PROTOCOL,
capabilities: { tools: {} },
serverInfo: { name: SERVER_NAME, version: VERSION },
};
case 'tools/list':
return { tools: TOOLS };
case 'tools/call':
return callTool(message.params?.name, message.params?.arguments);
case 'ping':
return {};
default:
throw { code: -32601, message: `method not found: ${String(message.method)}` };
}
}
/**
* 解析并执行一条 JSON 消息。
* @returns 响应信封对象;notification(无 id)返回 null;非法 JSON 返回 undefined。
*/
export async function dispatch(raw) {
let message;
try {
message = JSON.parse(raw);
} catch {
return undefined;
}
if (message.id === undefined) return null; // 通知不响应
try {
return { jsonrpc: '2.0', id: message.id, result: await handleRequest(message) };
} catch (error) {
const e = error;
return {
jsonrpc: '2.0',
id: message.id,
error: { code: typeof e.code === 'number' ? e.code : -32603, message: String(e.message ?? error) },
};
}
}