Struct McpConfig 

pub struct McpConfig {
    pub mcp_servers: HashMap<String, McpServerConfig>,
}

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

This represents the complete MCP configuration file that Claude Code reads to connect to MCP servers. The file may contain both AGPM-managed and user-managed server configurations.

Fields

mcp_servers: HashMap<String, McpServerConfig>

Map of server names to their configurations

Implementations

impl McpConfig

pub fn load_or_default(path: &Path) -> Result<Self>

Load an existing .mcp.json file or create a new empty configuration.

This method preserves all existing server configurations, including user-managed ones.

pub fn save(&self, path: &Path) -> Result<()>

Save the configuration to a .mcp.json file.

The file is written atomically to prevent corruption.

pub fn update_managed_servers( &mut self, updates: HashMap<String, McpServerConfig>, ) -> Result<()>

Update only AGPM-managed servers, preserving user configurations.

This method:

1. Removes old AGPM-managed servers not in the update set
2. Adds or updates AGPM-managed servers from the update set
3. Preserves all user-managed servers (those without AGPM metadata)

pub fn check_conflicts( &self, new_servers: &HashMap<String, McpServerConfig>, ) -> Vec<String>

Check for conflicts with user-managed servers.

Returns a list of server names that would conflict with existing user-managed servers.

pub fn remove_all_managed(&mut self)

Remove all AGPM-managed servers.

This is useful for cleanup operations.

pub fn get_managed_servers(&self) -> HashMap<String, &McpServerConfig>

Get all AGPM-managed servers.

Trait Implementations

impl Debug for McpConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for McpConfig

fn default() -> McpConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for McpConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for McpConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.