SWOFT Workspace MCP Server - Unified Package

🎯 The One Package to Rule Them All!

This consolidated package combines:

• ✅ MCP Server (Claude Desktop/Code integration)
• ✅ Virtual Filesystem (JSON ↔ MongoDB)
• ✅ 25 VFS Scripts (GTD, auto-setup, monitoring)
• ✅ 12 CLI Commands
• ✅ Script Execution via MCP

📖 See UNIFIED-PACKAGE-GUIDE.md for complete documentation.

Installation

Global Installation

npm install -g @swoft/workspace-mcp-server

Local Development

npm install
npm run build

Claude Desktop Integration

Using Claude MCP CLI

# Add to Claude Desktop
claude mcp add swoft-workspace npx @swoft/workspace-mcp-server

# List connected servers
claude mcp list

# Remove if needed
claude mcp remove swoft-workspace

Manual Configuration

Add to your Claude Desktop settings (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "swoft-workspace": {
      "command": "node",
      "args": ["dist/server.js"],
      "cwd": "/Users/derick/projects/professional/swoft/swoft-workspace-platform/packages/mcp-server",
      "env": {
        "NODE_ENV": "development"
      }
    }
  }
}

Note: Replace the cwd path with your actual project path if different.

Features

Resources (Query Operations)

• workspace-context - Current workspace structure and projects
• team-composition - Team member profiles and roles
• project-portfolio - Customer projects and revenue tracking
• business-canvas/{customerId} - Business model canvases
• swoft-vfs/{path} - Virtual filesystem navigation
• codebase-architecture/{projectPath} - Architecture analysis

Tools (Command Operations)

• search_domain_knowledge - Search for domain concepts and patterns
• query_repository_intelligence - Git repository investigation
• validate_recursive_domain_model - Domain model validation
• assess_business_intelligence - Business metrics assessment

Development

# Build
npm run build

# Development with watch
npm run dev

# Start server
npm start

Troubleshooting

Connection Issues

1. Ensure Claude Desktop is restarted after configuration changes
2. Check that the server builds successfully: npm run build
3. Test server startup: npx @swoft/workspace-mcp-server
4. Verify connection: claude mcp list should show ✓ Connected

Common Problems

• Server not found: Run npm run build first
• Permission errors: Check file permissions on dist/server.js
• Connection failed: Restart Claude Desktop after config changes

License

Private - Internal use only