.mcp.json.example

{
  "$schema": "https://cdn.jsdelivr.net/npm/@anthropic-ai/claude-code@latest/schemas/mcp.schema.json",
  "description": "MCP servers configuration for MAP Framework - EXAMPLE FILE",
  "_comment": "This is an EXAMPLE configuration. Copy to .mcp.json and adjust for your environment. Most users should rely on their global ~/.claude.json configuration instead.",
  "_warning": "Project-specific .mcp.json overrides global ~/.claude.json settings. Only use if you need project-specific MCP configuration.",

  "mcpServers": {
    "sequential-thinking": {
      "_comment": "Anthropic's Sequential Thinking - Provides structured chain-of-thought reasoning",
      "_install": "Automatically installed via npx",
      "_required_for": "Complex problem solving, multi-step reasoning in MAP agents",
      "_docs": "https://github.com/modelcontextprotocol/servers/tree/main/src/sequentialthinking",
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    },

    "deepwiki": {
      "_comment": "DeepWiki - Official remote MCP server for GitHub repository analysis",
      "_install": "No installation needed - remote SSE server",
      "_required_for": "GitHub repository documentation and analysis (optional)",
      "_docs": "https://docs.devin.ai/work-with-devin/deepwiki-mcp",
      "_note": "Free, no authentication required",
      "type": "sse",
      "url": "https://mcp.deepwiki.com/sse"
    }
  },

  "_installation_notes": {
    "global_vs_local": "Most users should configure MCP servers in ~/.claude.json globally. Only use project-specific .mcp.json if you need different configurations per project.",
    "environment_variables": "Environment variables like ${OPENAI_API_KEY} are expanded from your shell environment or .env file.",
    "required_servers": [
      "sequential-thinking - Essential for complex reasoning"
    ],
    "optional_servers": [
      "deepwiki - Recommended for GitHub repository analysis"
    ],
    "alternative_installations": {
      "deepwiki": "Alternative transport: https://mcp.deepwiki.com/mcp (Streamable HTTP)"
    }
  }
}