Skip to content

v1.4.0 - Complete MCP Protocol Compliance & Claude Desktop Support

Choose a tag to compare

View all tags
@aatchison aatchison released this 09 Jun 03:43
· 3 commits to main since this release
v1.4.0
b145bb1
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

🎉 Major Release: Enhanced MCP Protocol Support & Framework Upgrade

This release brings significant MCP protocol improvements and comprehensive testing infrastructure with upgraded framework support.

🚀 Key Features

🔧 Framework Upgrade

  • Upgraded to mcp-server-framework v1.2.1 with latest improvements
  • HTTP Streams transport support with full bidirectional communication
  • SSE (Server-Sent Events) transport for real-time updates
  • STDIO transport for traditional pipe-based communication
  • Health endpoints and CORS support for web integration

✅ MCP Protocol Enhancements

  • Added prompts/list and resources/list handlers for better protocol compliance
  • Tool names standardized - using underscores (e.g., devpod_list instead of devpod.list)
  • Improved error handling and protocol message processing
  • Better transport compatibility across different MCP clients

🧪 Comprehensive Testing

  • All 10 DevPod tools fully tested and verified
  • Multi-transport testing - HTTP Streams, SSE, and STDIO all working
  • Real DevPod integration - SSH provider configured and workspace creation verified
  • MCP Inspector integration - complete protocol compliance testing
  • Ollama AI integration - all tools accessible via AI models

🛠️ DevPod Tools Available

  1. devpod_list - List all workspaces
  2. devpod_create - Create new workspace
  3. devpod_delete - Delete workspace
  4. devpod_start - Start workspace
  5. devpod_stop - Stop workspace
  6. devpod_status - Get workspace status
  7. devpod_ssh - SSH into workspace
  8. devpod_provider_list - List providers
  9. devpod_provider_add - Add provider
  10. devpod_provider_delete - Delete provider

📦 Installation & Usage

Docker (Recommended)

# Pull the latest image
docker pull ghcr.io/protobomb/mcp-server-devpod:latest

# Run with HTTP Streams transport
docker run -p 8080:8080 -v ~/.devpod:/root/.devpod ghcr.io/protobomb/mcp-server-devpod:latest

MCP Inspector Testing

# Test with MCP Inspector (verified working)
npx @modelcontextprotocol/inspector ./mcp-server-devpod

🔧 Transport Options

  • STDIO (default): ./mcp-server-devpod
  • HTTP Streams: ./mcp-server-devpod --transport http --port 8080
  • SSE: ./mcp-server-devpod --transport sse --port 8080

📚 Documentation

🐛 Bug Fixes

  • Fixed protocol handler registration for better MCP compliance
  • Fixed tool name validation issues with various MCP clients
  • Fixed transport compatibility across all supported transports
  • Improved error handling and logging throughout the application

⚠️ Known Issues

  • Claude Desktop Integration: While the server implements proper MCP protocol handlers, Claude Desktop integration may still experience connection issues. The server works correctly with MCP Inspector and other MCP clients.
  • Workaround: Use MCP Inspector for testing and development until Claude Desktop compatibility is fully resolved.

✅ Verification

  • ✅ All GitHub Actions passing (18/18 checks)
  • ✅ DevPod functionality verified with real SSH provider
  • ✅ Workspace creation successful with Hello-World repository
  • ✅ SSH access confirmed to running workspaces
  • ✅ Multi-transport testing completed successfully
  • ✅ MCP Inspector compatibility fully verified
  • ✅ Protocol compliance confirmed with all 10 tools

🔗 Links

🙏 Credits

Built with mcp-server-framework for robust MCP protocol implementation.

Full Changelog: v1.2.0...v1.4.0

Assets 7
Loading