open-index/open-npm huggingface dataset:
npm package: @swoft/workspace-mcp-server
Description: SWOFT Workspace MCP Server with integrated Virtual Filesystem - Complete AI-native workspace management
Latest version: 1.0.4

# 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](./UNIFIED-PACKAGE-GUIDE.md) for complete documentation.**

## Installation

### Global Installation
```bash
npm install -g @swoft/workspace-mcp-server
```

### Local Development
```bash
npm install
npm run build
```

## Claude Desktop Integration

### Using Claude MCP CLI
```bash
# 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`):
```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

```bash
# 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