项目简介

condamcp 是一个基于 Model Context Protocol (MCP) 构建的服务器实现集合,旨在通过自然语言交互方式,简化 conda 生态系统的操作。它充当用户意图和 conda 强大功能之间的桥梁,使得环境管理、包构建和 conda 操作对所有技能水平的用户都变得容易访问。

主要功能点

  • 自然语言操作 Conda: 允许用户使用自然语言与 conda 进行交互,例如创建、管理和清理 conda 环境,安装、卸载和升级软件包等。
  • 系统信息查询: 提供查询本地系统信息的功能,例如 CPU、内存、操作系统、磁盘和 GPU 信息,帮助 AI 客户端更好地做出决策。
  • Conda 包构建: 支持使用自然语言构建 conda 软件包,简化本地软件包的构建流程。
  • MCP 标准协议: 基于 MCP 标准构建,易于与支持 MCP 协议的客户端集成,实现标准化的上下文信息和功能提供。

安装步骤

  1. 克隆仓库:
    git clone https://github.com/jnoller/condamcp.git
    cd condamcp
  2. 创建 conda 环境:
    conda create -n condamcp pip
    conda activate condamcp
  3. 安装项目:
    pip install -e .

服务器配置

要配置 MCP 服务器以供 MCP 客户端(例如 Claude)使用,您需要编辑客户端的配置文件(例如 'claude_desktop_config.json')。在 'mcpServers' 部分添加以下服务器配置信息。请根据您的 conda 安装路径修改 'command' 字段。

{
  "mcpServers": {
    "Sysinfo": {
      "command": "/opt/homebrew/anaconda3/bin/conda",  // 请替换为您的 conda 路径
      "args": ["run", "-n", "condamcp", "--no-capture-output", "sysinfo"],
      "name": "Sysinfo" // 服务器名称,可自定义
    },
    "Conda": {
      "command": "/opt/homebrew/anaconda3/bin/conda",  // 请替换为您的 conda 路径
      "args": ["run", "-n", "condamcp", "--no-capture-output", "condamcp"],
      "name": "Conda"   // 服务器名称,可自定义
    },
    "CondaBuild": {
      "command": "/opt/homebrew/anaconda3/bin/conda",  // 请替换为您的 conda 路径
      "args": ["run", "-n", "condamcp", "--no-capture-output", "condabuild"],
      "name": "CondaBuild" // 服务器名称,可自定义
    }
  }
}

配置参数说明:

  • command: 启动 MCP 服务器的命令,这里使用 'conda run' 来在 'condamcp' 环境中运行服务器。请务必替换 '/opt/homebrew/anaconda3/bin/conda' 为您实际的 conda 可执行文件路径。
  • args: 传递给 'conda run' 命令的参数列表:
    • 'run': conda 的运行命令。
    • '-n condamcp': 指定在 'condamcp' 环境中运行。
    • '--no-capture-output': 确保服务器输出直接显示,而不是被捕获。
    • 'sysinfo', 'condamcp', 'condabuild': 分别指定启动 'Sysinfo', 'Conda', 'CondaBuild' MCP 服务器。
  • name: 服务器的名称,在客户端配置中用于标识不同的 MCP 服务器连接。

基本使用方法

  1. 启动 MCP 服务器: MCP 服务器在配置到 MCP 客户端后,通常由客户端自动启动。您无需手动运行服务器代码。

  2. 使用 MCP Inspector 调试 (可选): 您可以使用 MCP Inspector 工具来测试和调试 MCP 服务器。

    npx @modelcontextprotocol/inspector <path to conda> run -n <conda env> --no-capture-output <entrypoint>

    例如,调试 'CondaMCP' 服务器:

    npx @modelcontextprotocol/inspector /opt/homebrew/anaconda3/bin/conda run -n condamcp --no-capture-output condamcp

    请将 '/opt/homebrew/anaconda3/bin/conda' 替换为您的 conda 路径。

  3. 在 MCP 客户端中使用: 配置完成后,您可以在支持 MCP 协议的客户端(如 Claude)中使用自然语言指令,通过配置的服务器名称 (例如 "Conda", "Sysinfo", "CondaBuild") 调用 conda 相关的功能。

信息

分类

开发者工具