metool-mcp 0.1.0

MCP server for metool - a shell environment incubator

metool-mcp

MCP (Model Context Protocol) server for metool - a shell environment incubator.

Features

This MCP server provides AI assistants with tools to manage metool repository manifests and synchronization:

Tools

• add_repo_entry - Add repository entries to .repos.txt files
• sync_directory - Run mt sync to clone/update repositories and create symlinks
• list_repos - List repositories from .repos.txt files

Prompts

• conventions_add - Guide for adding conventions repositories
• manage_repos - Comprehensive guide for repository management

Resources

• repos-file - Access contents of repos.txt files

Installation

Via uvx (recommended)

uvx install metool-mcp

Via pip

pip install metool-mcp

From source

git clone https://github.com/mbailey/metool.git
cd metool/mcp
pip install -e .

Usage

With Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "metool": {
      "command": "uvx",
      "args": ["metool-mcp"]
    }
  }
}

Slash Commands

After configuring, you can use these commands in Claude:

• /metool:conventions-add mbailey/conventions - Add conventions to your project
• /metool:manage-repos - Get help managing repository files

Example Workflow

1. Add a conventions repository:

   /metool:conventions-add mbailey/conventions
   

   This will:

   • Add "mbailey/conventions .conventions" to .repos.txt
   • Run mt sync to clone and symlink the repository

2. Add custom repositories:

   # The MCP server can help you:
   - Add entries to .repos.txt
   - Sync to clone/update repositories
   - List current repository configuration
   

Requirements

• Python 3.10+
• metool installed and available in PATH
• Git for repository operations

Development

# Install in development mode
cd metool/mcp
pip install -e .

# Run tests
pytest

# Run the server directly
python -m metool_mcp.server

License

Same as metool - see main repository for license information.