Nex Context MCP Server

使用说明(简要概览,便于快速上手)

  • 项目简介

    • Nex Context MCP Server 是一个完整的 MCP 服务器实现,负责对接 LLM 客户端,提供统一的资源管理、工具执行和提示模板渲染等能力。服务器端实现了 JSON-RPC 风格的 API,支持通过不同传输通道进行通信(如标准输入输出、HTTP 等),并内置会话管理和多工具集成。
  • 主要功能点

    • 资源与记忆:提供对知识资源的托管、检索与上下文注入能力,便于 LLM 客户端调用与记忆管理。
    • 工具注册与执行:对外暴露大量工具(如查询、创建和更新各种对象、扫描文件、集成等),LLM 客户端可通过 MCP 调用执行外部功能。
    • Prompt 模板渲染:支持将 Nex 提供的上下文信息渲染为可注入对话的提示模板(Prompts)。
    • 会话管理与能力声明:实现会话键映射、跨轮对话上下文传递等。
    • 多传输协议:内置 Stdio 与 HTTP 的传输实现,方便在 Claude Desktop、Cursor、Windsurf、Claude Code 等客户端中接入。
    • 安全与扩展:通过 API Key 授权、分层工具结构和清晰的工具注册接口,便于扩展和自定义。
  • 安装与运行

    • 进入 MCP 服务器目录,安装依赖并运行(两种常用方式之一):
      • 使用 TSX 直接运行 TS 源码(开发友好方式):
        • 命令示例(以实际路径替换): npx tsx /path/to/nex-as-a-skill/mcp/src/index.ts
      • 先构建再直接执行编译产物(生产环境方式):
        • 构建后通常生成 dist 目录,直接 Node 执行 dist/index.js(具体路径视构建输出而定)。
    • 服务器启动后,MCP 客户端需要通过配置将服务器信息注册到客户端配置中,以实现通信与请求调用。
    • 配置示例(供 MCP 客户端使用,不需要客户端额外解析,只作参考;请按实际环境替换路径与 API key):
      • server name: nex
      • command: npx
      • args: ["tsx", "/path/to/nex-as-a-skill/mcp/src/index.ts"]
      • env: { "NEX_API_KEY": "sk-your_key_here" }
  • 服务器配置(MCP 客户端所需的配置信息) 为 MCP 客户端提供的连接信息示例(JSON 格式,便于直接粘贴到客户端配置中): { "serverName": "nex", "command": "npx", "args": ["tsx", "/path/to/nex-as-a-skill/mcp/src/index.ts"], "env": { "NEX_API_KEY": "sk-your_key_here" } // 说明:NEX_API_KEY 为可选项,若未注册将进入注册模式,请在注册后重新配置 Key。 }

  • 基本使用方法

    • 启动:按照上述两种方式之一启动 MCP 服务器。
    • 客户端接入:在 LLM 客户端配置中指定对应的 mcpServers.nex 条目,提供启动命令、参数和可选环境变量。
    • 工具与资源访问:客户端通过 MCP 服务器暴露的工具接口执行外部功能,使用资源与上下文注入来增强对话内容。
    • 会话与证书:服务器具备会话管理能力,支持跨轮对话的上下文保持;若需跨工具使用,请在客户端正确维护会话标识。

服务器信息