About asdf-mcp-plugin
asdf-mcp-plugin is an MCP plugin for the asdf version manager, intended for users who want a consistent way to install and switch MCP server versions. It can list available versions and select an active version.
Key features
- 01Install MCP servers through asdf
- 02List available versions
- 03Switch the active server version
- 04Support several MCP server types
Use cases
- 01Install an MCP server with asdf
- 02Switch between server versions
- 03Manage supported MCP server types
MCP support
The plugin manages MCP server installation and versions; it is not itself an MCP server. Supported types include claude-server, mcp-core, local-llm, and custom-mcp.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEasdf-mcp-plugin
Model Context Protocol (MCP) plugin for the asdf version manager.
Contents
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 servermcp-core: Reference implementation of the MCP protocollocal-llm: For running local language models with MCP compatibilitycustom-mcp: For custom MCP server implementations
Contributing
Contributions of any kind welcome!
License
MIT © hongsw
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.