Neocortica MCP 服务端

关键词

LLM context serverTools registryJSON-RPCstdio transportAI research automation

使用说明（Markdown 格式）

  • 项目简介 Neocortica 提供一个 MCP 服务器实现，负责注册与暴露一组可由 LLM 客户端调用的工具、管理资源、以及支持提示模板（Prompts）的渲染与获取。服务器通过 JSON-RPC 与客户端通信，当前实现通过标准输入输出（Stdio）作为传输通道，便于在本地或容器环境中与 Claude Code 等 MCP 客户端对接。

  • 主要功能点

    • 工具注册与执行：实现多组工具（如 paper_content、acd_search、web_search、pplx 等）的注册与调用，允许 LLM 客户端通过统一接口执行外部功能。
    • 资源与内容处理：封装对论文、网页等内容的获取、缓存与元数据管理，支持将外部数据转换为 LLM 易用的上下文。
    • Prompts 与模板：提供用于渲染和管理提示模板的能力，方便定义和获取交互所需的 Prompts。
    • JSON-RPC 与 传输适配：实现 MCP 的核心通信协议，当前使用 StdioServerTransport，未来可扩展为 SSE、WebSocket 等传输。
    • 会话与扩展性：具备会话管理、工具注册清单、进度回报等机制，便于在长流程中向客户端报告进度与结果。

  • 安装与运行步骤

    • 克隆代码库并安装依赖
    • 运行 MCP 服务器（快速起步通常使用以下命令之一）：npm install 与 npm run mcp（文档中已有对应快速启动指引）
    • 启动后，MCP 客户端应以标准 MCP.json 配置与服务器建立连接（后文提供客户端配置示例）

  • 服务器配置（给 MCP 客户端的连接信息示例，使用 JSON 格式，含 server name、command、args 等） { "server_name": "neocortica", "command": "npm", "args": ["run", "mcp"], "description": "Neocortica 的 MCP 服务器启动命令，使用标准 MCP JSON-RPC 传输（当前采用 Stdio 传输）。", "notes": "如需访问外部服务，请在环境变量中配置相应的 API Key/Token，如 BRAVE、APIFY、PERPLEXITY、MINERU、UNPAYWALL、ARXIV 等所需的 KEY。" }

  • 基本使用方法

    1. 启动服务器：在仓库根目录执行 npm install 之后执行 npm run mcp，确保依赖环境就绪。
    2. 客户端连接：基于 MCP 客户端的要求，通过上述配置让客户端建立连接，客户端将通过 JSON-RPC 调用注册的工具、获取资源和提示模板。
    3. 调用工具与获取结果：客户端可通过 MCP 请求调用 paper_content、acd_search、web_search、pplx 等工具，服务器将执行并以 MCP 规定的响应格式返回结果。
    4. 会话与进度：服务器实现了进度回调与日志信息上报，便于客户端跟踪长任务的执行状态。

  • 额外说明

    • 本实现包含对多种数据源的封装（ArXiv、Semantic Scholar、Unpaywall、Perplexity、Brave、MinerU 等），并将结果可缓存或以 Markdown 形式保存，便于后续对话中作为上下文使用。
    • MCP 客户端不需要关心服务器内部实现细节，只需按照 MCP 的 JSON-RPC 约定发起请求即可。

服务器信息

访问项目