Developer Research MCP Server

开发人员研究MCP服务器

该存储库包含一个模型上下文协议（MCP）服务器，旨在为AI代理或其他开发工具提供结构化的研究功能，主要是网络搜索。MCP实现了客户端（如AI代理）和提供专用工具的服务器之间的标准化通信。

该服务器最初使用OpenRouter进行网络搜索功能，但采用可扩展的架构构建，以便将来轻松集成其他研究提供商（例如，其他搜索引擎、数据库）。

目录

• 开发人员研究MCP服务器

- 目录 - 特性 - 体系结构和可扩展性 - 先决条件 - 安装 - 配置 - 消费 - 使用Roo代码 - 可用工具 - 搜索web - 参数 - 示例（概念性Roo代码使用） - 响应格式 - 许可证

特性

• 通过OpenRouter等提供商提供网络搜索功能。
• 针对检索技术和软件开发内容进行了优化。
• 专为可扩展性而设计，以支持多个研究提供商。
• 实现可靠的错误处理和重试机制。
• 以适合编程使用的结构良好、一致的JSON格式交付结果。

体系结构和可扩展性

该服务器采用模块化架构。每个研究提供者（如OpenRouter）都被实现为一个遵循通用接口的独立模块。这一设计原则使以下操作变得简单：

1. 添加对新搜索引擎或数据源的支持。
2. 根据配置或请求参数在提供者之间切换（未来增强）。
3. 独立维护和更新特定于提供者的逻辑。

先决条件

• v18或更高版本
• （附带Node.js）
• 所需研究提供商的API密钥（例如，OpenRouter）

安装

1. 克隆存储库：

   git clone https://github.com/yourusername/developer-research-server.git # Replace with the actual URL
   cd developer-research-server

1. 安装依赖项：

使用npm安装项目依赖项。

   npm install

1. 构建项目：

将TypeScript代码编译为JavaScript。

   npm run build

编译后的输出将在 build/ 目录。

配置

服务器是使用环境变量配置的。

1. 创建一个 .env 文件：

复制 mcp-config-sample.json （如果可用，或手动创建一个） .env 项目根目录中的文件。

   # Example .env file content:
   OPENROUTER_API_KEY=your_openrouter_api_key_here
   OPENROUTER_API_URL=https://openrouter.ai/api/v1

_注意：确保 .env 文件已添加到您的 .gitignore 为了避免泄露秘密。_

1. 所需的环境变量：

- OPENROUTER_API_KEY （OpenRouter提供商需要）：您唯一的OpenRouter API密钥。 - OPENROUTER_API_URL （可选）：OpenRouter API的基本URL。默认为 https://openrouter.ai/api/v1.

_未来的提供者可能需要不同的环境变量。_

消费

此MCP服务器在直接运行时通过标准输入/输出（stdio）监听请求。它旨在集成到Roo Code等工具中。

使用Roo代码

要将此服务器与Roo代码一起使用，请将以下配置添加到您的 .roo/mcp.json 文件。调整 args 指向已编译文件的路径 index.js 克隆存储库位置中的文件。

{
  "mcpServers": {
    "developer-research": {
      // Changed name to be more generic
      "command": "node",
      "args": ["/full/path/to/your/developer-research-server/build/index.js"], // <-- IMPORTANT: Update this path
      "env": {
        // Environment variables are typically loaded from the .env file
        // Or can be explicitly set here if needed, but .env is recommended for secrets
        // "OPENROUTER_API_KEY": "your-openrouter-api-key", // <-- Replace or load from .env
        // "OPENROUTER_API_URL": "https://openrouter.ai/api/v1"
      },
      "alwaysAllow": ["search_web"], // List tools the agent can always use
      "timeout": 60 // Timeout in seconds
    }
  }
}

重要提示：

• 替换 /full/path/to/your/developer-research-server/build/index.js 在您的系统上使用正确的绝对路径。
• 确保 OPENROUTER_API_KEY 优选地通过 .env 文件由服务器进程本身加载，而不是硬编码 mcp.json.

可用工具

目前，服务器提供以下工具：

搜索web

使用配置的提供程序（当前为OpenRouter）执行web搜索，并返回相关结果。

参数

• query （字符串，必填）：搜索查询。
• num_results （整数，可选）：所需的搜索结果数量。必须介于1和10之间。默认为5。
• focus （字符串，可选）：指定搜索的焦点区域。支持的值： "technical", "development", "general".默认为 "technical".

示例（概念性Roo代码使用）

// Within a Roo Code agent or script
const searchResults = await useMcpTool("developer-research", "search_web", {
  query: "advanced typescript patterns",
  num_results: 3,
  focus: "technical",
});

console.log(searchResults);

响应格式

该工具返回一个具有以下结构的JSON对象：

{
  "success": true, // Boolean indicating if the search was successful
  "results": [
    // Array of result objects
    {
      "title": "Title of the search result",
      "url": "https://example.com/page",
      "content": "A snippet or summary of the page content...",
      "domain": "example.com"
    }
    // ... more results
  ],
  "total_results": 3 // The actual number of results returned
}

如果出现错误，响应可能如下：

{
  "success": false,
  "error": "Description of the error that occurred."
}

许可证

麻省理工学院