github yusufkaraaslan/Skill_Seekers v2.4.0
on GitHub

9 hours ago

[2.4.0] - 2025-12-25

🚀 MCP 2025 Upgrade - Multi-Agent Support & HTTP Transport

This major release upgrades the MCP infrastructure to the 2025 specification with support for 5 AI coding agents, dual transport modes (stdio + HTTP), and a complete FastMCP refactor.

🎯 Major Features

MCP SDK v1.25.0 Upgrade

  • Upgraded from v1.18.0 to v1.25.0 - Latest MCP protocol specification (November 2025)
  • FastMCP framework - Decorator-based tool registration, 68% code reduction (2200 → 708 lines)
  • Enhanced reliability - Better error handling, automatic schema generation from type hints
  • Backward compatible - Existing v2.3.0 configurations continue to work

Dual Transport Support

  • stdio transport (default) - Standard input/output for Claude Code, VS Code + Cline
  • HTTP transport (new) - Server-Sent Events for Cursor, Windsurf, IntelliJ IDEA
  • Health check endpoint - GET /health for monitoring
  • SSE endpoint - GET /sse for real-time communication
  • Configurable server - --http, --port, --host, --log-level flags
  • uvicorn-powered - Production-ready ASGI server

Multi-Agent Auto-Configuration

  • 5 AI agents supported:
    • Claude Code (stdio)
    • Cursor (HTTP)
    • Windsurf (HTTP)
    • VS Code + Cline (stdio)
    • IntelliJ IDEA (HTTP)
  • Automatic detection - agent_detector.py scans for installed agents
  • One-command setup - ./setup_mcp.sh configures all detected agents
  • Smart config merging - Preserves existing MCP servers, only adds skill-seeker
  • Automatic backups - Timestamped backups before modifications
  • HTTP server management - Auto-starts HTTP server for HTTP-based agents

Expanded Tool Suite (17 Tools)

  • Config Tools (3): generate_config, list_configs, validate_config
  • Scraping Tools (4): estimate_pages, scrape_docs, scrape_github, scrape_pdf
  • Packaging Tools (3): package_skill, upload_skill, install_skill
  • Splitting Tools (2): split_config, generate_router
  • Source Tools (5): fetch_config, submit_config, add_config_source, list_config_sources, remove_config_source

Added

Core Infrastructure

  • server_fastmcp.py (708 lines) - New FastMCP-based MCP server

    • Decorator-based tool registration (@safe_tool_decorator)
    • Modular tool architecture (5 tool modules)
    • HTTP transport with uvicorn
    • stdio transport (default)
    • Comprehensive error handling

  • agent_detector.py (333 lines) - Multi-agent detection and configuration

    • Detects 5 AI coding agents across platforms (Linux, macOS, Windows)
    • Generates agent-specific config formats (JSON, XML)
    • Auto-selects transport type (stdio vs HTTP)
    • Cross-platform path resolution

  • Tool modules (5 modules, 1,676 total lines):

    • tools/config_tools.py (249 lines) - Configuration management
    • tools/scraping_tools.py (423 lines) - Documentation scraping
    • tools/packaging_tools.py (514 lines) - Skill packaging and upload
    • tools/splitting_tools.py (195 lines) - Config splitting and routing
    • tools/source_tools.py (295 lines) - Config source management

Setup & Configuration

  • setup_mcp.sh (rewritten, 661 lines) - Multi-agent auto-configuration

    • Detects installed agents automatically
    • Offers configure all or select individual agents
    • Manages HTTP server startup
    • Smart config merging with existing configurations
    • Comprehensive validation and testing

  • HTTP server - Production-ready HTTP transport

    • Health endpoint: /health
    • SSE endpoint: /sse
    • Messages endpoint: /messages/
    • CORS middleware for cross-origin requests
    • Configurable host and port
    • Debug logging support

Documentation

  • docs/MCP_SETUP.md (completely rewritten) - Comprehensive MCP 2025 guide

    • Migration guide from v2.3.0
    • Transport modes explained (stdio vs HTTP)
    • Agent-specific configuration for all 5 agents
    • Troubleshooting for both transports
    • Advanced configuration (systemd, launchd services)

  • docs/HTTP_TRANSPORT.md (434 lines, new) - HTTP transport guide

  • docs/MULTI_AGENT_SETUP.md (643 lines, new) - Multi-agent setup guide

  • docs/SETUP_QUICK_REFERENCE.md (387 lines, new) - Quick reference card

  • SUMMARY_HTTP_TRANSPORT.md (360 lines, new) - Technical implementation details

  • SUMMARY_MULTI_AGENT_SETUP.md (556 lines, new) - Multi-agent technical summary

Testing

  • test_mcp_fastmcp.py (960 lines, 63 tests) - Comprehensive FastMCP server tests

    • All 17 tools tested
    • Error handling validation
    • Type validation
    • Integration workflows

  • test_server_fastmcp_http.py (165 lines, 6 tests) - HTTP transport tests

    • Health check endpoint
    • SSE endpoint
    • CORS middleware
    • Argument parsing

  • All tests passing: 602/609 tests (99.1% pass rate)

Changed

MCP Server Architecture

  • Refactored to FastMCP - Decorator-based, modular, maintainable
  • Code reduction - 68% smaller (2200 → 708 lines)
  • Modular tools - Separated into 5 category modules
  • Type safety - Full type hints on all tool functions
  • Improved error handling - Graceful degradation, clear error messages

Server Compatibility

  • server.py - Now a compatibility shim (delegates to server_fastmcp.py)
  • Deprecation warning - Alerts users to migrate to server_fastmcp
  • Backward compatible - Existing configurations continue to work
  • Migration path - Clear upgrade instructions in docs

Setup Experience

  • Multi-agent workflow - One script configures all agents
  • Interactive prompts - User-friendly with sensible defaults
  • Validation - Config file validation before writing
  • Backup safety - Automatic timestamped backups
  • Color-coded output - Visual feedback (success/warning/error)

Documentation

  • README.md - Added comprehensive multi-agent section
  • MCP_SETUP.md - Completely rewritten for v2.4.0
  • CLAUDE.md - Updated with new server details
  • Version badges - Updated to v2.4.0

Fixed

  • Import issues in test files (updated to use new tool modules)
  • CLI version test (updated to expect v2.3.0)
  • Graceful MCP import handling (no sys.exit on import)
  • Server compatibility for testing environments

Deprecated

  • server.py - Use server_fastmcp.py instead
    • Compatibility shim provided
    • Will be removed in v3.0.0 (6+ months)
    • Migration guide available

Infrastructure

  • Python 3.10+ - Recommended for best compatibility
  • MCP SDK: v1.25.0 (pinned to v1.x)
  • uvicorn: v0.40.0+ (for HTTP transport)
  • starlette: v0.50.0+ (for HTTP transport)

Migration from v2.3.0

Upgrade Steps:

  1. Update dependencies: pip install -e ".[mcp]"
  2. Update MCP config to use server_fastmcp: 
    {
  "mcpServers": {
    "skill-seeker": {
      "command": "python",
      "args": ["-m", "skill_seekers.mcp.server_fastmcp"]
    }
  }
}
  3. For HTTP agents, start HTTP server: python -m skill_seekers.mcp.server_fastmcp --http
  4. Or use auto-configuration: ./setup_mcp.sh

Breaking Changes: None - fully backward compatible

New Capabilities:

  • Multi-agent support (5 agents)
  • HTTP transport for web-based agents
  • 8 new MCP tools
  • Automatic agent detection and configuration

Contributors

Check out latest releases or
releases around yusufkaraaslan/Skill_Seekers v2.4.0

Don't miss a new Skill_Seekers release

NewReleases is sending notifications on new releases.

Get notifications