llm-tools-mcp 0.1.0a5

MCP support for LLM CLI

llm-tools-mcp

[!WARNING] Work in progress!
Only an alpha version has been released so far.
Please refrain from using it unless you know what you're doing.
If you do decide to try it, make sure to use the --ta flag (manual approval required for every tool execution).

MCP support for the LLM CLI tool.

To Do

• Release alpha version
• Build a solid test suite
  • test sse with dummy server
  • test stdio with dummy server
  • test http streamable with dummy server (see #1)
  • test sse with real server
  • test stdio with real server
  • test http streamable with real server
• Redirect stdout/stderr from the MCP SDK to a file or designated location
• Reuse stdio connections
• Support non-stdio MCP servers
• Handle tool name conflicts (prefix with mcp server name?)
• Gather feedback on the ~/.llm-tools-mcp directory naming
• Improve failure handling:
  • When connecting to an MCP server fails
  • When mcp.json is malformed
• Improve this README:
  • Add more detail in the Development section (mention uv?)

Installation

Install this plugin in the same environment as LLM:

llm install llm-tools-mcp

Usage

[!WARNING] Work in progress!
Only an alpha version has been released so far.
Please refrain from using it unless you know what you're doing.
If you do decide to try it, make sure to use the --ta flag (manual approval required for every tool execution).

1. Create mcp.json file in ~/.llm-tols-mcp
2. Run llm, for example: llm --ta -T read_file -T list_allowed_directories -T list_directory "what files are in the demo directory? show me contents of one of the files (any)"

Development

Now (to be verified)

• Sync dependencies: uv sync --all-extras
• Run linters / type checker: ./check.sh
• Run tests: ./test.sh

Before

To set up this plugin locally, first checkout the code. Then create a new virtual environment:

cd llm-tools-mcp
python -m venv venv
source venv/bin/activate

Now install the dependencies and test dependencies:

python -m pip install -e '.[test]'

To run the tests:

python -m pytest