The ASDF Plugin for MCP Server Management is a tool designed to simplify the installation and management of Model Context Protocol (MCP) servers. It integrates with the ASDF version manager to provide a uniform interface for installing, switching between, and managing different versions of MCP-compatible servers.
Before using the plugin, ensure you have the following utilities installed:
bash
curl
tar
jq
These are generic POSIX utilities required for the plugin to function.
To install the plugin, use the following commands:
asdf plugin add mcp https://github.com/hongsw/asdf-mcp-plugin.git
To install a specific version of an MCP server:
# 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
The plugin provides several commands to manage MCP servers:
# 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
The plugin currently supports the following MCP-compatible servers:
claude-server
: Anthropic's Claude API compatible servermcp-core
: Reference implementation of the MCP protocollocal-llm
: For running local language models with MCP compatibilitycustom-mcp
: For custom MCP server implementationsContributions of any kind are welcome! If you'd like to contribute to the project, please follow the standard GitHub workflow for pull requests.
This project is licensed under the MIT License. For more details, see the LICENSE file.
For more information, visit the GitHub repository.