asdf-mcp-plugin

What is asdf-mcp-plugin?

asdf-mcp-plugin is a plugin for the asdf version manager that provides a unified interface to install, manage, and use various Model Context Protocol (MCP) servers. It aims to simplify the installation and version management of MCP-compatible servers by removing the need for manual setup per server type.

How to use asdf-mcp-plugin?

Install the plugin with asdf plugin add mcp https://github.com/hongsw/asdf-mcp-plugin.git, then install MCP server versions using asdf install mcp latest. Manage servers with commands such as asdf mcp list-servers, asdf mcp install <server-name> <version>, asdf mcp use <server-name> <version>, asdf mcp start <server-name>, and asdf mcp status.

Key features of asdf-mcp-plugin

• Manages multiple MCP server versions via a single interface.
• Supports install, use, start, and status commands.
• Works with asdf’s existing version management workflow.
• Requires only common POSIX utilities: bash, curl, tar, jq.

Use cases of asdf-mcp-plugin

• Installing and switching between different MCP server versions for compatibility testing.
• Starting a specific MCP server directly from the command line.
• Checking the status of running MCP servers.
• Managing MCP server versions alongside other asdf-managed tools.

FAQ from asdf-mcp-plugin

What MCP servers does it support?

The plugin currently supports claude-server, mcp-core, local-llm, and custom-mcp.

What system dependencies are needed?

It requires bash, curl, tar, and jq.

How do I list available MCP server types?

Run asdf mcp list-servers to see all supported server names.

How do I install a specific MCP server version?

Use asdf mcp install <server-name> <version> (e.g., asdf mcp install claude-server 1.0.0).

How do I start a MCP server?

Run asdf mcp start <server-name> to launch the server.