使用说明

项目简介

NCP（Natural Context Provider）是一个基于 MCP（Model Context Protocol）的服务器实现。它将海量工具、资源与提示模板集中管理，向 LLM 客户端以标准化方式暴露上下文和能力，便于 AI 在生成、调度和执行任务时获得一致、可控的上下文信息。

主要功能点

• MCP 协议支持：能够处理 MCP 规范定义的 JSON-RPC 请求，返回标准化的 JSON-RPC 响应，支持初始化、工具列表、工具调用等核心请求。
• 资源与工具管理：托管和管理 Resources（资源）与 Tools（工具），支持注册、查询和执行。
• Prompt 定义与渲染：允许定义和渲染提示模板（Prompts），以规范化的交互方式帮助 LLM 客户端获取上下文信息和指令模板。
• 会话与能力声明：提供会话管理、能力声明、以及对外暴露的功能能力信息。
• 多传输协议：内置对 stdio、HTTP/SSE、WebSocket 等传输的支持，便于本地或远程 MCP 实例与客户端连接。
• 安全与可扩展性：包含对工具执行的权限/安全检查、插件化能力和健康监控框架，便于扩展和保障稳定性。

安装步骤

• 使用 Node.js 18+ 环境
• 全局安装并运行 MCP 服务器（推荐方式之一）：
  • npm install -g @portel/ncp
  • 通过 ncp 命令启动并配置您的 MCP 集群

服务器配置

MCP 客户端需要的核心配置信息示例（JSON 形式，具体字段含义如下所示）： { "mcpServers": { "ncp": { "name": "ncp", "command": "ncp", "args": [] } } } 字段说明：

• mcpServers：要注册的 MCP 服务器集合。
• ncpName（示例中的键名）: MCP 服务器的标识名称，客户端可据此定位。
• name：服务器在 MCP 客户端侧的显示名称，通常与实际实现的 MCP 名称一致。
• command：启动 MCP 服务器的命令（如 ncp），用于客户端远程启动或本地调用。
• args：启动命令的参数列表，若无额外参数可填空数组。

注：以上配置是供 MCP 客户端了解连接信息的描述性信息，实际运行时需根据环境调整命令与参数。

基本使用

• 通过 MCP 客户端连接 NCP 提供的工具和资源，进行工具发现、调用和 Prompts 的渲染。
• 使用内置的健康监控与 scheduling 功能，对 MCP 实例的健康状态和任务计划进行管理。
• 结合 Photon 运行时、Project 级配置与本地/远程 MCP 的组合，构建统一的上下文服务层，提升大模型对外部能力的利用效率。