bretbouchard/Local_Intelligence_MCP

Local Intelligence MCP

A cross-platform Swift-based Model Context Protocol (MCP) server that provides comprehensive text processing and content analysis tools to AI agents while maintaining strict security and privacy requirements.

✨ Features

• 🔧 MCP Protocol Compliance: Full implementation of the Model Context Protocol specification
• 📝 Text Processing Tools: 21 professional tools for text analysis, summarization, and content processing
• 🔍 Content Analysis: Advanced PII detection, intent analysis, and content categorization
• 🛡️ Privacy Preserving: Built-in PII redaction with audio term preservation
• 🔒 Enterprise-Grade Security: Comprehensive security testing and protection against attacks
• 🚀 High Performance: Concurrent request handling with memory optimization
• 🐳 Cross-Platform: Builds and runs on macOS, Linux, and other platforms
• 📱 Offline Capable: Core functionality works without network connectivity
• ⚡ Streaming Support: Handles large documents with efficient streaming processing

Requirements

• Swift: 6.0 or later
• Platforms: macOS 12.0+, Linux (Ubuntu 20.04+)
• Memory: 512MB minimum, 1GB recommended
• Storage: 100MB for installation

Installation

Build from Source

git clone https://github.com/bretbouchard/Local_Intelligence_MCP.git
cd Local_Intelligence_MCP
swift build -c release

Docker Installation

# Build Docker image
docker build -t local-intelligence-mcp .

# Run the container
docker run -p 3000:3000 local-intelligence-mcp

# Or use docker-compose
docker-compose up -d

Run

swift run LocalIntelligenceMCP

Configuration

Create a configuration file at ~/.config/local-intelligence-mcp-server/config.json:

{
  "server": {
    "host": "localhost",
    "port": 8050,
    "maxClients": 10
  },
  "security": {
    "requireAuthentication": false,
    "allowedClients": ["localhost"]
  },
  "features": {
    "shortcuts": { "enabled": true },
    "voiceControl": { "enabled": true },
    "systemInfo": { "enabled": true }
  }
}

Environment Variables

The server can also be configured using environment variables:

# Override default port
export MCP_SERVER_PORT=8050

# Override host
export MCP_SERVER_HOST=0.0.0.0

# Override max clients
export MCP_MAX_CLIENTS=20

# Enable features
export MCP_ENABLE_SHORTCUTS=true
export MCP_ENABLE_VOICE_CONTROL=true
export MCP_ENABLE_SYSTEM_INFO=true

# Set log level
export MCP_LOG_LEVEL=info

🛠️ Available MCP Tools

Text Processing Tools

Content Analysis Tools

Summarization Tools

Extraction Tools

Catalog Tools

System Tools

🔐 Security Features

• Input Validation: Comprehensive validation and sanitization of all inputs
• Permission Enforcement: Role-based access control with granular permissions
• Attack Protection: Protection against injection, timing, and memory attacks
• Rate Limiting: Brute force and dictionary attack protection
• Audit Logging: Complete security event logging and monitoring
• Session Management: Secure session handling with hijacking protection

Usage with AI Assistants

Add to your AI assistant configuration:

{
  "mcpServers": {
    "local-intelligence-mcp": {
      "type": "stdio",
      "command": "swift",
      "args": [
        "run",
        "--package-path",
        "/your/path/local_intelligence_mcp",
        "LocalIntelligenceMCP",
        "start-command",
        "--mcp-mode"
      ]
    }
  }
}

Or use environment variables:

{
  "mcpServers": {
    "local-intelligence-mcp": {
      "command": "local-intelligence-mcp-server",
      "env": {
        "MCP_SERVER_PORT": "8050"
      }
    }
  }
}

Development

Project Structure

Sources/LocalIntelligenceMCP/
├── Core/                # MCP protocol implementation
├── Tools/               # MCP tool implementations
├── Services/            # Apple API integrations
├── Security/            # Privacy and security features
├── Models/              # Data models
└── Utils/               # Common utilities

🧪 Testing

This project includes a comprehensive test suite with 400+ test methods covering:

Test Categories

• Unit Tests: Individual component testing with 200+ methods
• Integration Tests: End-to-end workflow testing with 20+ methods
• Performance Tests: Concurrent load testing with 10+ methods
• Security Tests: Attack surface analysis with 22+ methods

Running Tests

# Run all tests
swift test

# Run specific test categories
swift test --filter SecurityAuditTests
swift test --filter ConcurrencyTests
swift test --filter EndToEndTests

# Run with verbose output
swift test --verbose

# Run specific test
swift test --filter testSecurityAudit_MaliciousParameterInjection

Test Coverage

• Security Testing: Comprehensive validation against OWASP Top 10
• Performance Testing: Load testing up to 100 concurrent requests
• Integration Testing: Complete user story workflows
• Model Testing: All data models with edge case validation

Code Style

This project uses SwiftLint and SwiftFormat for consistent code style:

# Install tools (if not already installed)
brew install swiftlint swiftformat

# Run linting
swiftlint

# Format code
swiftformat .

🔒 Security and Privacy

🛡️ Security Features

• Comprehensive Input Validation: Protection against injection attacks
• Role-Based Access Control: Granular permission enforcement
• Attack Surface Protection: Defense against timing, memory, and concurrency attacks
• Rate Limiting: Brute force and dictionary attack prevention
• Session Security: Hijacking and privilege escalation protection
• Audit Logging: Complete security event monitoring and logging

🛡️ Privacy Features

• No persistent storage of sensitive user data
• Apple Keychain integration for secure credential storage
• Memory-safe Swift 6 implementation with strict concurrency
• Information disclosure prevention
• Zero-knowledge architecture for sensitive operations

🧪 Security Testing

The server includes 22 comprehensive security tests covering:

• Input validation and sanitization testing
• Authentication and authorization testing
• Attack surface analysis and penetration testing
• Dictionary attack protection verification
• Timing attack vulnerability detection
• Memory exhaustion protection testing
• Concurrency abuse resistance validation
• Race condition vulnerability detection
• Information disclosure analysis
• Protocol abuse prevention

Total Security Test Coverage: 300+ security scenarios across all attack vectors

📚 API Documentation

MCP Protocol Endpoints

Server Information

{
  "jsonrpc": "2.0",
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {
      "tools": {
        "listChanged": true
      }
    }
  }
}

Tool List

{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "result": {
    "tools": [
      {
        "name": "shortcuts_execute",
        "description": "Execute Apple Shortcuts",
        "inputSchema": {
          "type": "object",
          "properties": {
            "shortcutName": {"type": "string"},
            "input": {"type": "object"},
            "timeout": {"type": "number", "default": 30}
          },
          "required": ["shortcutName"]
        }
      }
    ]
  }
}

Tool Usage Examples

Execute Shortcut

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "shortcuts_execute",
    "arguments": {
      "shortcutName": "Send Email",
      "input": {
        "to": "user@example.com",
        "subject": "Meeting Reminder",
        "body": "Don't forget our meeting at 2 PM"
      },
      "timeout": 60
    }
  }
}

Get System Information

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "system_info",
    "arguments": {
      "categories": ["device", "performance", "network"],
      "includeSensitive": false
    }
  }
}

Voice Control Command

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "voice_control",
    "arguments": {
      "command": "Open Safari and go to apple.com",
      "timeout": 30,
      "accessibility": true
    }
  }
}

Response Format

Success Response

{
  "jsonrpc": "2.0",
  "id": "request-id",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Shortcut executed successfully"
      }
    ],
    "isError": false
  }
}

Error Response

{
  "jsonrpc": "2.0",
  "id": "request-id",
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": {
      "details": "shortcutName is required"
    }
  }
}

🏗️ Architecture

Swift 6 Concurrency Model

• Actor-based Design: Thread-safe concurrent operations
• Strict Concurrency: Compile-time data race prevention
• Async/Await: Modern asynchronous programming patterns
• Task Groups: Structured concurrency for complex operations

Security Architecture

• Zero-Trust Security: All inputs validated and sanitized
• Layered Defense: Multiple security controls at each layer
• Fail-Safe Defaults: Secure by default configuration
• Audit Trail: Complete logging of security events

Performance Characteristics

• Concurrent Request Handling: 100+ simultaneous requests
• Memory Efficiency: Optimized memory usage patterns
• Low Latency: Sub-100ms response times for most operations
• Resource Management: Automatic cleanup and resource pooling

Constitution

This project follows the which defines core principles:

1. MCP Protocol Compliance - Strict adherence to MCP standards
2. Security & Privacy First - User data protection as priority
3. Swift-Native Implementation - Native Apple platform development
4. Tool-Based Architecture - Modular, independently testable design
5. Offline-First Design - Core functionality works offline

Documentation

Contributing

1. Fork the repository
2. Create a feature branch
3. Follow the constitution and code style guidelines
4. Add tests for new functionality
5. Ensure all tests pass
6. Submit a pull request

License

[License Name] - see LICENSE file for details.

Support

• Issues
• Discussions
• Documentation