🦕 Deno MCP Server Monorepo
A comprehensive monorepo containing a secure Model Context Protocol (MCP) server
built with Deno and a VS Code extension for seamless integration.
📦 Packages
| Package | Description | Version | Tests |
|---|---|---|---|
| Server | Deno MCP Server with 6 tools | 🧪 Comprehensive | |
| VS Code Extension | Private extension with auto-detection | 🧪 70+ Tests |
🚀 Quick Start
For Users
Download Latest Release:```bash
Get the latest release
curl -s https://api.github.com/repos/emmettirl/deno-mcp-server/releases/latest \
| grep browser_download_url \
| cut -d '"' -f 4 \
| wget -qi -
Install VS Code extension
code --install-extension deno-mcp-extension.vsix
**Using Docker:**```bash
docker pull ghcr.io/emmettirl/deno-mcp-server/server:latest
docker run -it ghcr.io/emmettirl/deno-mcp-server/server:latest
For Developers```bash
Clone and setup
git clone https://github.com/emmettirl/deno-mcp-server.git
cd deno-mcp-server
Build everything
deno run --allow-all scripts/build.ts all
OR on Windows:
.\scripts\build.ps1 all
Run tests
deno run --allow-all scripts/build.ts test
Start development
cd packages/server && deno run --allow-all cli.ts
## 🏗️ Build System
Unified PowerShell build script with comprehensive commands:````powershell
**Usage:**
```bash
# Cross-platform (recommended)
deno run --allow-all scripts/build.ts [options]
# Windows PowerShell
.\scripts\build.ps1 [options]````
Commands:
fmt Format code in both packages\
lint Run linting on both packages
check Type check both packages
test Run all tests (70+ tests total)
build Build both packages
package Package both for distribution
all Run fmt, lint, check, test, build, package
clean Clean build artifacts
Options:
-ServerOnly Only operate on server package
-ExtOnly Only operate on extension package\
-ShowVerbose Show detailed output
````
## 🤖 Automated Releases
### Release Triggers
**Automatic (Tag-based):**```bash
git tag v1.2.3
git push origin v1.2.3
# → Triggers full release pipeline
````
**Manual (GitHub Actions):**
- Go to Actions → 🚀 Release → Run workflow
- Configure what to release (server, extension, both)
- Set version and options
### Release Artifacts
Each release automatically creates:
- 🏗️ **Cross-platform Binaries**
- Windows: `deno-mcp-server-windows-x64.exe`
- Linux: `deno-mcp-server-linux-x64`
- macOS: `deno-mcp-server-macos-x64`
- 🎯 **VS Code Extension**
- `deno-mcp-extension.vsix` - Installable extension package
- 🐳 **Docker Images**
- `ghcr.io/emmettirl/deno-mcp-server/server:latest`
- `ghcr.io/emmettirl/deno-mcp-server/server:v1.2.3`
- 📝 **Release Notes** - Auto-generated with installation instructions
### CI/CD Pipeline```mermaid
graph LR
A[Push/Tag] --> B[🧪 Test All]
B --> C[🦕 Build Server]
B --> D[🎯 Build Extension]
B --> E[🐳 Build Docker]
C --> F[📦 Create Release]
D --> F
E --> F
F --> G[📤 Upload Assets]
🔒 Security Features
- Multi-layered Security: Permission-based access control
- Input Validation: Comprehensive sanitization
- Secure Operations: Safe file and process handling
- Container Security: Minimal attack surface
- Automated Scanning: Security checks in CI/CD
- Signed Releases: Verified build artifacts
🧪 Testing
Comprehensive test coverage across both packages:
- Server: Deno test suite with security, validation, and integration tests
- Extension: 70+ VS Code integration tests with mocking
- E2E: Cross-package integration testing
- CI: Automated testing on every PR and release```bash
Run all tests
deno run --allow-all scripts/build.ts test
Test individual packages
.\scripts\build.ps1 test -ServerOnly
.\scripts\build.ps1 test -ExtOnly# Coverage reports
cd packages/server && deno test --coverage --allow-all
cd packages/vscode-extension && npm run test:coverage
```
📊 Development Stats
- Languages: TypeScript (Deno + Node.js)
- Test Coverage: 70+ tests across packages
- Build Time: ~2 minutes for full pipeline
- Binary Size: ~50MB cross-platform
- Extension Size: ~1MB packaged
🏆 Features
Server Package
- 🛠️ 6 MCP Tools: fmt, lint, check, test, run, info
- 🔒 Secure by Default: Multi-layered permissions
- 🐳 Docker Ready: Production containers
- 📦 Cross-platform: Windows, Linux, macOS
- ⚡ Fast: Native Deno performance
VS Code Extension
- 🎯 Auto-detection: Finds packaged servers
- 📊 Status Integration: Real-time server status
- 🧪 70+ Tests: Comprehensive coverage
- 🔌 Private Extension: No marketplace dependency
- 🚀 Zero Config: Works out of the box
📖 Documentation
Comprehensive documentation is organized in the docs/ directory:
📚 For Users
- Project-Wide Operations Guide - Using MCP tools on entire projects
- Usage Examples - Code samples and tutorials
🔧 For Developers
- API Documentation - Complete API reference
- Security Guidelines - Security implementation details
- Build Instructions - Development setup and build process
- Copilot Configuration - GitHub Copilot remote work setup
🐛 Fixes & Troubleshooting
- MCP Workspace Fix - Resolving workspace root issues
- Line Ending Fix - Cross-platform consistency fixes
🔄 Development Workflows
- Tool Enhancements - Recent improvements summary
- Publisher Update - Extension identifier changes
📦 Package-Specific Documentation
- Server Package - MCP server implementation details
- VS Code Extension - Extension development guide
🤝 Contributing
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Make changes and run tests (
deno run --allow-all scripts/build.ts test) - Commit changes (
git commit -m 'feat: add amazing feature') - Push to branch (
git push origin feature/amazing-feature) - Open a Pull Request
📄 License
This project is licensed under the MIT License - see the LICENSE file
for details.
🚀 Built with Deno • 🎯 Integrated with VS Code
⚡ Disclaimer: Vibe-coded with Claude Sonnet 4 and GitHub Copilot Agent✨
