LLM工具MCP插件

一个用于从shell连接到MCP服务器的LLM插件,提供动态工具执行和配置管理功能。

  • by VirtusLab
  • Python
  • 本地部署
  • 37 星标
  • 更新于
在 GitHub 查看 VirtusLab/llm-tools-mcp

使用说明

llm-tools-mcp

直接从您的shell连接到MCP服务器。插件用于 大语言模型 (由 @西蒙).

[!注意] 当前重点: 授权#4

安装

在与相同的环境中安装此插件 LLM:

llm install llm-tools-mcp

用法

[!警告] 建议使用 --ta 标记并批准每个工具的执行。

  1. 创建 mcp.json 文件在 ~/.llm-tools-mcp.

    示例文件:

    {
      "mcpServers": {
        "filesystem": {
          "command": "npx",
          "args": [
            "-y",
            "@modelcontextprotocol/server-filesystem",
            "~/demo"
          ]
        }
      }
    }
    
  2. 列出可用工具。

    [!警告] llm tools 不适用于动态工具箱(看这个), 因此作为MCP的一部分加载的工具将不可见。

    llm tools list
    
  3. 跑 llm 使用工具。

    llm --ta -T MCP "what files are in the demo directory? show me contents of one of the files (any)"
    

其他示例

动态更改MCP配置:

llm --ta -T 'MCP("/path/to/custom/mcp.json")' "your prompt here"

发展

现在(待核实)

  • 同步依赖关系: uv sync --all-extras
  • 运行过梁/类型检查器: ./check.sh
  • 运行测试: ./test.sh
  • 运行端到端测试: ./e2e/e2e-docker.sh

待办

  • [x] 发布alpha版本
  • [x] 支持所有运输
    • [x] 可流式传输http
    • [x] sse
    • [x] stdio
  • []构建一个可靠的测试套件
    • [x] 测试配置文件验证
    • [x] 使用虚拟服务器测试sse
    • [x] 使用虚拟服务器测试stdio
    • [x] 使用虚拟服务器测试http流(见#1)
    • [x] 使用真实服务器对sse进行手动测试
    • [x] 使用真实服务器对stdio进行手动测试
    • [x] 使用真实服务器对http流进行手动测试
  • [x] 重定向 stdout/stderr 从MCP SDK到文件或指定位置
  • []重用stdio连接
  • [x] 支持非stdio MCP服务器
  • []处理工具名称冲突(前缀为mcp服务器名称?)
  • []收集关于 ~/.llm-tools-mcp 目录命名
  • [x] 改进故障处理:
    • [x] 连接到MCP服务器失败时
    • [x] 何时 mcp.json 格式不正确
  • []改进此自述文件:
    • []在中添加更多详细信息 发展 节(提及 uv?)