feat: Add experimental MCP tools integration for enhanced codebase analysis

## New Features
- **MCP Tools Integration**: Added support for Model Context Protocol tools
  - Exa MCP Server: External API patterns and best practices
  - Code Index MCP: Advanced internal codebase search and indexing
- **Enhanced Workflow Planning**: Updated pre_analysis to include MCP tool steps
- **Documentation Updates**: Added MCP tool setup guides and usage examples

## Changes
### Core Components
- Updated `plan.md` with MCP integration principles and implementation approach guidelines
- Added MCP tool steps in pre_analysis workflow: `mcp_codebase_exploration`, `mcp_external_context`
- Enhanced context accumulation with external best practices lookup

### Documentation
- Added comprehensive MCP tools section in both English and Chinese README
- Updated installation requirements and integration guidelines
- Added GitHub repository links for required MCP servers

### Agent Enhancements
- Updated multiple agents to support MCP tool integration
- Enhanced context gathering capabilities with external pattern analysis

## Technical Details
- MCP tools provide faster analysis through direct codebase indexing
- Automatic fallback to traditional bash/CLI tools when MCP unavailable
- Enhanced pattern recognition and similarity detection capabilities

🧪 **Experimental**: MCP integration is currently experimental and optional

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

.claude/agents/action-planning-agent.md

@@ -71,6 +71,7 @@ You are a pure execution agent specialized in creating actionable implementation
 4. Use consolidated analysis to inform implementation stages and task breakdown
 
 #### Analysis Dimensions Coverage
+- **Exa Research**: Use `mcp__exa__get_code_context_exa` for technology stack selection and API patterns
 - Architecture patterns and component relationships
 - Implementation conventions and coding standards
 - Module dependencies and integration points

.claude/agents/code-developer.md

@@ -85,6 +85,12 @@ ELIF context insufficient OR task has flow control marker:
 
 **Rule**: Before referencing modules/components, use `rg` or search to verify existence first.
 
+**MCP Tools Integration**: Use Code Index and Exa for comprehensive development:
+- Find existing patterns: `mcp__code-index__search_code_advanced(pattern="auth.*function")`
+- Locate files: `mcp__code-index__find_files(pattern="src/**/*.ts")`
+- Get API examples: `mcp__exa__get_code_context_exa(query="React authentication hooks", tokensNum="dynamic")`
+- Update after changes: `mcp__code-index__refresh_index()`
+
 **Test-Driven Development**:
 - Write tests first (red → green → refactor)
 - Focus on core functionality and edge cases

.claude/agents/code-review-test-agent.md

@@ -159,6 +159,11 @@ if [FAST_MODE]: apply targeted review process
 - Missing or unused imports identification
 - Circular dependency detection
 
+**MCP Tools Integration**: Use Code Index for comprehensive analysis:
+- Pattern discovery: `mcp__code-index__search_code_advanced(pattern="import.*from", context_lines=2)`
+- File verification: `mcp__code-index__find_files(pattern="**/*.test.js")`
+- Post-review refresh: `mcp__code-index__refresh_index()`
+
 ### Performance
 - Algorithm complexity (time and space)
 - Database query optimization

.claude/agents/conceptual-planning-agent.md

@@ -86,17 +86,17 @@ def handle_brainstorm_assignment(prompt):
 
 ### Role-Specific Analysis Dimensions
 
-| Role | Primary Dimensions | Focus Areas |
-|------|-------------------|--------------|
-| system-architect | architecture_patterns, scalability_analysis, integration_points | Technical design and system structure |
-| ui-designer | user_flow_patterns, component_reuse, design_system_compliance | UI/UX patterns and consistency |
-| business-analyst | process_optimization, cost_analysis, efficiency_metrics, workflow_patterns | Business process and ROI |
-| data-architect | data_models, flow_patterns, storage_optimization | Data structure and flow |
-| security-expert | vulnerability_assessment, threat_modeling, compliance_check | Security risks and compliance |
-| user-researcher | usage_patterns, pain_points, behavior_analysis | User behavior and needs |
-| product-manager | feature_alignment, market_fit, competitive_analysis | Product strategy and positioning |
-| innovation-lead | emerging_patterns, technology_trends, disruption_potential | Innovation opportunities |
-| feature-planner | implementation_complexity, dependency_mapping, risk_assessment | Development planning |
+| Role | Primary Dimensions | Focus Areas | Exa Usage |
+|------|-------------------|--------------|-----------|
+| system-architect | architecture_patterns, scalability_analysis, integration_points | Technical design and system structure | `mcp__exa__get_code_context_exa("microservices patterns")` |
+| ui-designer | user_flow_patterns, component_reuse, design_system_compliance | UI/UX patterns and consistency | `mcp__exa__get_code_context_exa("React design system patterns")` |
+| business-analyst | process_optimization, cost_analysis, efficiency_metrics, workflow_patterns | Business process and ROI | `mcp__exa__get_code_context_exa("business workflow automation")` |
+| data-architect | data_models, flow_patterns, storage_optimization | Data structure and flow | `mcp__exa__get_code_context_exa("database schema patterns")` |
+| security-expert | vulnerability_assessment, threat_modeling, compliance_check | Security risks and compliance | `mcp__exa__get_code_context_exa("security authentication patterns")` |
+| user-researcher | usage_patterns, pain_points, behavior_analysis | User behavior and needs | `mcp__exa__get_code_context_exa("user research methodologies")` |
+| product-manager | feature_alignment, market_fit, competitive_analysis | Product strategy and positioning | `mcp__exa__get_code_context_exa("product management frameworks")` |
+| innovation-lead | emerging_patterns, technology_trends, disruption_potential | Innovation opportunities | `mcp__exa__get_code_context_exa("emerging technology trends")` |
+| feature-planner | implementation_complexity, dependency_mapping, risk_assessment | Development planning | `mcp__exa__get_code_context_exa("agile development patterns")` |
 
 ### Output Integration
 

.claude/agents/general-purpose.md

@@ -31,6 +31,7 @@ You are a versatile execution specialist focused on completing high-quality task
 ### 1. Context Assessment
 **Input Sources**:
 - User-provided task description and context
+- **MCP Tools Selection**: Choose appropriate tools based on task type (Code Index for codebase, Exa for research)
 - Existing documentation and examples
 - Project CLAUDE.md standards
 - Domain-specific requirements

.claude/agents/memory-gemini-bridge.md

@@ -15,11 +15,15 @@ Coordinate parallel execution of `~/.claude/scripts/update_module_claude.sh` scr
 
 ### 1. Analyze Project Structure
 ```bash
-# Step 1: Get module list with depth information
+# Step 1: Code Index architecture analysis
+mcp__code-index__search_code_advanced(pattern="class|function|interface", file_pattern="**/*.{ts,js,py}")
+mcp__code-index__find_files(pattern="**/*.{md,json,yaml,yml}")
+
+# Step 2: Get module list with depth information
 modules=$(Bash(~/.claude/scripts/get_modules_by_depth.sh list))
 count=$(echo "$modules" | wc -l)
 
-# Step 2: Display project structure
+# Step 3: Display project structure
 Bash(~/.claude/scripts/get_modules_by_depth.sh grouped)
 ```