MCP Server Troubleshooting Guide

# Verify installation
npm list -g initrepo-mcp

# Check if command is available
which initrepo-mcp

# Restart your IDE/editor
# For VS Code: Reload Window (Ctrl/Cmd + Shift + P)

# Check documentation structure
ls -la docs/

# Verify ID format
grep -r "T-001" docs/

# Validate documentation completeness
initrepo-mcp validate-docs

# Health check
curl https://mcp.initrepo.com/health

# Server status
initrepo-mcp status

# Configuration validation
initrepo-mcp validate-config

{
  "method": "tools/call",
  "params": {
    "name": "debug_getProjectMap",
    "arguments": {}
  }
}

# Required environment variables
export INITREPO_API_KEY="your-api-key"
export INITREPO_PROJECT_ID="your-project-id"
export INITREPO_DOCS_PATH="./docs"

# Optional performance tuning
export INITREPO_CACHE_SIZE="2GB"
export INITREPO_MAX_CONCURRENCY="10"
export INITREPO_TIMEOUT="60000"

// Check .initrepo/config.json
{
  "api": {
    "endpoint": "https://api.initrepo.com",
    "timeout": 30000
  },
  "cache": {
    "enabled": true,
    "ttl": 3600,
    "maxSize": "1GB"
  },
  "logging": {
    "level": "info",
    "file": "/var/log/initrepo-mcp.log"
  }
}

# Allow MCP server ports
sudo ufw allow 3000/tcp
sudo ufw allow 8080/tcp

# Test connectivity
curl -v https://mcp.initrepo.com/health
telnet mcp.initrepo.com 443

# Set proxy environment variables
export HTTP_PROXY="http://proxy.company.com:8080"
export HTTPS_PROXY="http://proxy.company.com:8080"
export NO_PROXY="localhost,127.0.0.1,.local"

# Test proxy connectivity
curl --proxy $HTTP_PROXY https://mcp.initrepo.com/health

# Collect system details
uname -a
node --version
npm --version

# MCP server version
initrepo-mcp --version

# Environment details
env | grep -i initrepo

# Server logs
tail -f /var/log/initrepo-mcp.log

# IDE integration logs
# Check IDE logs for MCP-related errors

# Network logs
tcpdump -i any port 3000 or port 8080

# Daily health check script
#!/bin/bash
# Check server status
curl -f https://mcp.initrepo.com/health

# Validate configuration
initrepo-mcp validate-config

# Check disk space
df -h | grep -E "(Avail|Use%)"

# Monitor memory usage
ps aux | grep initrepo-mcp | grep -v grep