mcpField
M
mcp-server-manager

mcp-server-manager

github.com/xiaolaiAgent workflows87864 installsUpdated today
Repository

About mcp-server-manager

An Agent skill for discovering, registering, and verifying MCP server configurations. It handles project-level `.mcp.json` files and global Claude Code settings.

Key features

  1. 01Scan project and global MCP configs
  2. 02Identify HTTP and stdio server types
  3. 03Register project or global servers
  4. 04Verify server registration
  5. 05Note session restart requirements

Use cases

  1. 01Review existing MCP server settings
  2. 02Add a server to a project or Claude Code
  3. 03Confirm registration and explain reload needs

MCP support

The skill registers MCP servers by editing `.mcp.json` or using Claude Code commands, then checks the configuration to verify the result.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/xiaolai/vmark --skill mcp-server-manager

After installing, type/mcp-server-managerin Claude Code to confirm it loaded.

Bundled filesscripts/scan_mcp_servers.py

Details

From the project README

MCP Server Manager

Workflow

  1. Discover candidate servers

    • Check project .mcp.json for existing server configs.
    • Check ~/.claude.json for global MCP servers (Claude Code).
    • Scan for MCP-related packages in package.json or Cargo.toml.

  2. Choose a registration target

    • Project-local: edit .mcp.json directly.
    • Global (Claude Code): use claude mcp add / claude mcp remove.

  3. Register the server

    • stdio server: 
      claude mcp add <name> -- <command> <args...>
    • stdio with env: 
      claude mcp add <name> -e KEY=VALUE -- <command> <args...>
    • Or edit .mcp.json directly for project-local config.

  4. Verify registration

    • For .mcp.json: read the file and confirm the entry exists.
    • For global: run claude mcp list to verify.

  5. Explain reload requirement

    • MCP servers are loaded at session start; ask the user to restart the session.

Notes

  • Infer type from config: url key = HTTP, command/args keys = stdio.
  • When multiple sources define the same name, confirm which to use.
  • For stdio servers using npx, the package downloads when the server first runs.

VMark Example

// .mcp.json
{
  "mcpServers": {
    "tauri": {
      "command": "npx",
      "args": ["-y", "@hypothesi/tauri-mcp-server"]
    }
  }
}

Comments

Markdown supported