Claude-Project-Coordinator

Claude Project Coordinator is an MCP server that helps you manage and coordinate multiple Xcode/Swift projects. It provides tools to track project status, store notes and metadata, search code patterns across projects and your knowledge base, and maintain a knowledge base of development insights. It also includes an analytics subsystem (v1.3.0+) that can generate time tracking data, activity heat maps, and technology trend analyses to help you understand project health and technology usage. Interaction is done through Claude’s natural language prompts using built-in MCP commands like listing projects, adding new ones, updating statuses, and running code-pattern searches.

Key capabilities include:

• Project management: keep track of multiple projects with status, notes, and metadata.
• Smart search: query across projects and knowledge base for code patterns and guidance.
• Knowledge base: store templates, patterns, and troubleshooting guides for reuse.
• Auto-detection: identifies technologies such as SwiftUI, UIKit, SPM, and other tech stacks within projects.
• Analytics: obtain time tracking, activity heat maps, health checks, and technology usage trends (v1.3.0+).
• Persistent storage: data is stored locally in structured JSON format for reliability and portability.

Usage is via Claude prompts that map to MCP actions such as listing projects, adding a new project with a path, updating statuses, performing pattern searches, and querying analytics data. For example, you can tell Claude to add a new SwiftUI project at a given path, then check its status, or ask for the technologies used most across your projects.

Prerequisites:

• macOS with Swift 5.9+
• Claude Desktop app

Install steps:

1. Clone the repository and build the project:

git clone https://github.com/M-Pineapple/Claude-Project-Coordinator.git
cd Claude-Project-Coordinator
swift build -c release

2. Locate the built executable path. It is typically:

.build/release/project-coordinator

3. Configure Claude Desktop to point to the MCP server:

• Open Claude Desktop
• Go to Settings → Developer → Model Context Protocol
• Add the configuration using the following JSON snippet:

{
  "mcpServers": {
    "project-coordinator": {
      "command": "/path/to/Claude-Project-Coordinator/.build/release/project-coordinator",
      "args": []
    }
  }
}

4. Restart Claude Desktop to apply the new MCP server configuration.

Notes and tips:

• If you encounter incorrect analytics dates after upgrades, run the repair script: ./scripts/repair-analytics-dates.sh. This fixes a bug related to analytics re-migration on restarts (fixed in v1.3.2).
• Security is enforced via hardcoded validation rules and input checks. You can review and adjust security thresholds in the source under Sources/ProjectCoordinator/SecurityValidator.swift, including allowed base paths and input length limits.
• MCP data is stored locally in JSON format within Knowledge Base directories (projects, patterns, templates, tools). Regular backups are recommended.
• The Analytics feature set is available for v1.3.0+ and includes time tracking, activity heat maps, and technology trends.
• When upgrading, rebuild the project to ensure security and analytics improvements are applied, then restart Claude Desktop to load the updated binary.