返回市场
大模型工具MCP

大模型工具MCP

作者:VirtusLab30 星标更新:2025-10-31

项目介绍

# `llm-tools-mcp`

![mcp-logo](https://gips0.baidu.com/it/u=1908689336,4007190868&fm=3081&app=3081&f=PNG?w=200&h=200)

**从您的shell直接连接到MCP服务器。这是[llm](https://github.com/simonw/llm)(由[@simonw](https://github.com/simonw)创建)的一个插件。**

[![PyPI](https://img.shields.io/pypi/v/llm-tools-mcp.svg)](https://pypi.org/project/llm-tools-mcp/)
[![Changelog](https://img.shields.io/github/v/release/VirtusLab/llm-tools-mcp?include_prereleases&label=changelog)](https://github.com/VirtusLab/llm-tools-mcp/releases)
[![Tests](https://github.com/VirtusLab/llm-tools-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/VirtusLab/llm-tools-mcp/actions/workflows/test.yml)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/VirtusLab/llm-tools-mcp/blob/main/LICENSE)


> [!Note]
> 当前重点:[授权 #4](https://github.com/VirtusLab/llm-tools-mcp/issues/4)


## 安装

在与[LLM](https://llm.datasette.io/)相同的环境中安装此插件:

```bash
llm install llm-tools-mcp

使用

[!WARNING] 建议使用--ta标志并批准每个工具执行。

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

    示例文件:

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

    [!WARNING] llm tools尚未实现动态工具箱支持(参见此链接),因此作为MCP一部分加载的工具不会显示。

    llm tools list
    
  3. 运行带有工具的llm

    llm --ta -T MCP "演示目录中有哪些文件?给我看其中一个文件的内容(任意一个)"
    

其他示例

动态更改您的MCP配置:

llm --ta -T 'MCP("/path/to/custom/mcp.json")' "在这里输入您的提示"

开发

现在(待验证)

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

待办事项

  • 发布alpha版本
  • 支持所有传输方式
    • 可流式传输的HTTP
    • SSE
    • 标准I/O
  • 构建一个可靠的测试套件
    • 测试配置文件验证
    • 使用虚拟服务器测试SSE
    • 使用虚拟服务器测试标准I/O
    • 使用虚拟服务器测试可流式传输的HTTP(参见#1
    • 手动测试使用真实服务器的SSE
    • 手动测试使用真实服务器的标准I/O
    • 手动测试使用真实服务器的可流式传输的HTTP
  • 将MCP SDK的stdout/stderr重定向到文件或指定位置
  • 重用标准I/O连接
  • 支持非标准I/O的MCP服务器
  • 处理工具名称冲突(前缀为MCP服务器名称?)
  • 收集关于~/.llm-tools-mcp目录命名的反馈
  • 改进失败处理:
    • 当连接到MCP服务器失败时
    • mcp.json格式不正确时
  • 改进此README:
    • 开发部分添加更多细节(提及uv?)