Module mcp 

MCP (Model Context Protocol) server configuration management for AGPM.

This module handles the integration of MCP servers with AGPM, including:

• Directly merging MCP server configurations into .mcp.json (no staging directory)
• Writing MCP server configurations to .mcp.json for Claude Code
• Managing AGPM-controlled MCP server configurations
• Preserving user-managed server configurations
• Safe atomic updates to MCP configuration files
• Multi-tool support via pluggable MCP handlers

Note: Hooks and permissions are handled separately and stored in .claude/settings.local.json

Modules

handlers

MCP server installation handlers for different tools.

Structs

AgpmMetadata

AGPM management metadata for tracking managed servers.

ClaudeSettings

Settings structure for .claude/settings.local.json. This represents the complete settings file that may contain various configurations.

McpConfig

The main MCP configuration file structure for .mcp.json.

McpServerConfig

Individual MCP server configuration.

Functions

clean_mcp_servers

Remove all AGPM-managed MCP servers from the configuration.

configure_mcp_servers

list_mcp_servers

List all MCP servers, indicating which are AGPM-managed.

merge_mcp_servers

Merge MCP server configurations into the config file.