返回 MCP 目录
public公开dns本地运行

mcp-inception

一个基于TypeScript的MCP服务器,实现LLM查询系统,支持任务委派和上下文窗口卸载。

article

README

🚀 MCP-Inception 服务器(MCP Server)

MCP-Inception 服务器允许你从一个 MCP 客户端调用另一个 MCP 客户端,实现任务分配和上下文窗口卸载,就像在一个代理中嵌套另一个代理!这是一个基于 TypeScript 的 MCP 服务器,实现了一个简单的 LLM 查询系统。

🚀 快速开始

MCP-Inception 服务器是一个强大的工具,可让你在一个程序中同时作为 MCP 服务器和客户端。它基于 mcp-client-cli 构建,支持卸载上下文窗口、分配任务以及并行和映射减少任务的执行。

✨ 主要特性

工具

  • execute_mcp_client:向另一个 LLM 提出问题,忽略其执行工具的所有中间步骤,直接返回输出。
    • 参数:将问题作为必需参数传入。
    • 返回值:返回答案,忽略所有中间上下文。
  • execute_parallel_mcp_client:接受一个输入列表和一个主提示,并为输入列表中的每个字符串并行执行提示。
    • 示例:获取 6 个主要城市(伦敦、巴黎、东京、里约、纽约、悉尼)的当前时间。
      • 使用“这个城市的时间是什么?”作为主提示。
      • 使用“London Paris 等”作为输入列表。
      • 并行为每个输入运行提示。
    • 注意:请等待之后再使用此功能。
  • execute_map_reduce_mcp_client:并行处理多个项目,然后依次将结果合并为一个输出。
    • 处理方式
      • 使用带有 {item} 占位符的 mapPrompt 进行单个项目处理。
      • 使用带有 {accumulator}{result} 占位符的 reducePrompt 进行结果组合。
    • 参数
      • 处理要分析的项目列表。
      • 可选的 initialValue 用于累加器。
    • 执行流程:并行处理项目,然后依次减少结果。
    • 示例用例:分析多个文档,然后从所有文档中综合出关键见解的摘要。

📦 安装指南

依赖项

  • 安装 mcp-client-cli,同时安装配置文件,并在 ~/.llm/config.json 中设置所需的 MCP 服务器。
  • 创建一个 bash 脚本文件,激活虚拟环境并执行 llm 可执行文件。
#!/bin/bash
source ./venv/bin/activate
llm --no-confirmations

安装包

  • 安装依赖项:
npm install
  • 构建服务器:
npm run build
  • 带有自动重建的开发:
npm run watch

与 Claude Desktop 集成

要与 Claude Desktop 一起使用,请在配置文件中添加服务器:

  • 在 MacOS 上:~/Library/Application Support/Claude/claude_desktop_config.json
  • 在 Windows 上:%APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp-inception": {
      "command": "node",
      "args": ["~/Documents/Cline/MCP/mcp-inception/build/index.js"], // 此仓库的 build/index.js
      "disabled": false,
      "autoApprove": [],
      "env": {
        "MCP_INCEPTION_EXECUTABLE": "./run_llm.sh", // Development->Dependencies 中的 bash 文件
        "MCP_INCEPTION_WORKING_DIR": "/mcp-client-cli 工作目录"
      }
    }
  }
}

调试

由于 MCP 服务器通过标准输入输出进行通信,调试可能具有挑战性。我们推荐使用 MCP Inspector,它作为程序脚本可用:

npm run inspector

Inspector 会提供一个访问浏览器调试工具的 URL。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端