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許可協議 - 完整許可證。

簡而言之：可免費用於所有用途，包括商業用途，但不能作為託管服務提供給第三方。