Ncp

🚀 NCP - 自然上下文提供器

NCP（自然上下文提供器）可将分散的多个MCP服务器整合为一个智能编排器。它能让AI摆脱工具过多带来的困扰，仅需面对2个简单工具，就能发挥原有能力，变得专注且高效，同时节省成本。

🚀 快速开始

前提条件

• Node.js 18+ （点击此处下载）
• npm （包含在Node.js中）或 npx 用于运行包
• 命令行访问权限 （Mac/Linux系统使用终端，Windows系统使用命令提示符或PowerShell）

已有MCP用户的2分钟设置

步骤1：导入现有MCP ⚡

如果您已经有MCP，无需重新开始，可立即导入所有内容：

# 全局安装NCP（推荐）
npm install -g @portel/ncp

# 将claude_desktop_config.json文件内容复制到剪贴板：
# 1. 打开claude_desktop_config.json文件（查看上述位置）
# 2. 全选内容（Ctrl+A / Cmd+A）并复制（Ctrl+C / Cmd+C）
# 3. 然后运行：
ncp config import

# ✨ 神奇之处！NCP会自动从剪贴板检测并导入所有MCP

注意：以下所有命令均假设为全局安装（npm install -g）。如需使用npx，请参阅 使用npx进行替代安装 部分。

步骤2：将NCP连接到您的AI 🔗

用以下 单个条目 替换整个MCP配置：

{
  "mcpServers": {
    "ncp": {
      "command": "ncp"
    }
  }
}

步骤3：见证神奇效果 ✨

您的AI现在只会看到2个简单工具，而不是50多个复杂工具：

🎉 完成！ 工具和功能不变，但您的AI现在更加 专注 和 高效。

✨ 主要特性

解决MCP悖论

• 避免AI选择错误工具：解决AI在众多MCP工具中难以抉择的问题，如不再纠结于使用 read_file 还是 get_file_content。
• 防止会话提前结束：避免因分析工具占用过多上下文导致会话提前结束。
• 控制成本：减少因大量工具模式消耗的令牌数量，降低成本。
• 让AI更果断：使AI摆脱犹豫不决的状态，恢复快速行动的能力。

提供聚焦约束

NCP为AI提供约束条件，激发其创造力，就像诗人在特定主题下更容易获得灵感，开发者在明确的语言要求下能更专注地解决问题。

显著改善使用效果

• 节省令牌：与直接连接多个MCP相比，可大幅减少工具模式占用的令牌数量，最高可节省87%。
• 加快响应速度：响应速度提升5倍，从8秒缩短至1.5秒。
• 延长会话时间：会话长度增加12倍，减少因上下文限制导致的会话中断。
• 降低工具选择错误率：错误工具选择率降低90%。
• 避免上下文耗尽：在典型会话中不会出现上下文耗尽的情况。

具备高级功能

• 智能健康监测：自动检测故障的MCP，并绕过它们进行路由，确保AI不会因工具故障而停滞。
• 多配置文件组织：可按项目或环境组织MCP，方便开发和生产环境的不同配置。
• 项目级配置：支持按项目配置MCP，并自动检测，适用于团队和云IDE。

📦 安装指南

使用npm全局安装（推荐）

npm install -g @portel/ncp

使用npx进行替代安装

如果您不想进行全局安装，可以使用 npx：

# 所有上述命令都可以使用npx - 只需将 'ncp' 替换为 'npx @portel/ncp'：

# 导入MCP
npx @portel/ncp config import

# 添加MCP
npx @portel/ncp add filesystem npx @modelcontextprotocol/server-filesystem ~/Documents

# 查找工具
npx @portel/ncp find "file operations"

# 配置客户端（示例：Claude Desktop）
{
  "mcpServers": {
    "ncp": {
      "command": "npx",
      "args": ["@portel/ncp"]
    }
  }
}

何时使用npx：适用于试用NCP、CI/CD环境或无法进行全局安装的情况。

💻 使用示例

基础用法

# 像AI一样提问：
ncp find "I need to read a file"
ncp find "help me send an email"
ncp find "search for something online"

高级用法

# 安全测试任何工具：
ncp run filesystem:read_file --params '{"path": "/tmp/test.txt"}'

📚 详细文档

试驾：亲身体验差异

NCP提供了一个对人类友好的CLI，您可以通过以下方式体验：

🔍 智能发现

ncp find "I need to read a file"
ncp find "help me send an email"
ncp find "search for something online"

NCP能够理解意图，而不仅仅是关键词，就像您的AI所需要的那样。

📋 生态系统概述

# 查看完整的MCP生态系统：
ncp list --depth 2

# 随时获取帮助：
ncp --help

⚡ 直接测试

# 安全测试任何工具：
ncp run filesystem:read_file --params '{"path": "/tmp/test.txt"}'

您可以像AI使用工具一样直接调试和测试工具。

不同AI客户端的配置

Claude Desktop（最常用）

配置文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

用以下内容替换整个 claude_desktop_config.json 文件：

{
  "mcpServers": {
    "ncp": {
      "command": "ncp"
    }
  }
}

📌 重要提示：保存配置文件后，重启Claude Desktop。

Claude Code

NCP可自动工作！只需运行：

ncp add <your-mcps>

VS Code与GitHub Copilot

设置文件位置：

• macOS：~/Library/Application Support/Code/User/settings.json
• Windows：%APPDATA%\Code\User\settings.json
• Linux：~/.config/Code/User/settings.json

在VS Code的 settings.json 文件中添加以下内容：

{
  "mcp.servers": {
    "ncp": {
      "command": "ncp"
    }
  }
}

📌 重要提示：保存设置文件后，重启VS Code。

Cursor IDE

{
  "mcp": {
    "servers": {
      "ncp": {
        "command": "ncp"
      }
    }
  }
}

免责声明：配置格式和位置可能因Cursor IDE版本而异。请参考 Cursor官方文档 获取最新的设置说明。

🔧 技术细节

如需了解技术细节，包括令牌分析、架构图和性能基准，请阅读 技术指南 →。您将了解到：

• 向量相似性搜索算法
• N对1的编排架构
• 实际令牌使用情况比较
• 健康监测和故障转移系统

🛟 故障排除

导入问题

# 检查导入内容
ncp list

# 验证导入的MCP健康状态
ncp config validate

# 查看详细的导入日志
DEBUG=ncp:* ncp config import

AI未使用工具

• 检查连接：运行 ncp list （应显示您的MCP）
• 测试发现功能：运行 ncp find "your query"
• 验证配置：确保您的AI客户端指向 ncp 命令

性能问题

# 检查MCP健康状态（不健康的MCP会降低整体性能）
ncp list --depth 1

# 如有需要，清除缓存
rm -rf ~/.ncp/cache

# 使用调试日志进行监控
DEBUG=ncp:* ncp find "test"

🤝 贡献代码

如果您想帮助改进NCP，可以通过以下方式贡献：

• 🐛 报告漏洞：GitHub Issues
• 💡 提出功能请求：GitHub Discussions
• 🔄 提交拉取请求：贡献指南

📄 许可证

本项目采用Elastic License 2.0许可协议 - 完整许可证。

简而言之：可免费用于所有用途，包括商业用途，但不能作为托管服务提供给第三方。