asdf-mcp-plugin

Model Context Protocol (MCP) plugin for the asdf version manager.

Contents

• Dependencies
• Install
• Why?
• Usage
• Supported MCP Servers
• Contributing
• License

Dependencies

• bash, curl, tar, jq: generic POSIX utilities.

Install

Plugin:

asdf plugin add mcp https://github.com/hongsw/asdf-mcp-plugin.git

mcp servers:

# Show all installable versions
asdf list-all mcp

# Install specific version
asdf install mcp latest

# Set a version globally (on your ~/.tool-versions file)
asdf global mcp latest

# Now mcp commands are available
mcp --version

Check asdf readme for more instructions on how to install & manage versions.

Why?

The MCP (Model Context Protocol) plugin for asdf simplifies the installation and management of various MCP-compatible servers. It provides a uniform interface for installing, switching between, and managing different versions of MCP servers, eliminating the complexity of manual installation processes for each server type.

Usage

# List all available MCP server types
asdf mcp list-servers

# Install a specific MCP server
asdf mcp install <server-name> <version>

# Set a specific MCP server as active
asdf mcp use <server-name> <version>

# Start an MCP server
asdf mcp start <server-name>

# Check status of running MCP servers
asdf mcp status

Supported MCP Servers

This plugin currently supports the following MCP-compatible servers:

• claude-server: Anthropic's Claude API compatible server
• mcp-core: Reference implementation of the MCP protocol
• local-llm: For running local language models with MCP compatibility
• custom-mcp: For custom MCP server implementations

Contributing

Contributions of any kind welcome!

License

MIT © hongsw