7afab18d2b6f16fabd3b1fe6f0c3c3630a29c0d9
2 Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
MiaoDX
|
bd974148a2 |
feat: Update MCP to use server_fastmcp with venv Python support
This PR improves MCP server configuration by updating all documentation to use the current server_fastmcp module and ensuring setup scripts automatically use virtual environment Python instead of system Python. ## Changes ### 1. Documentation Updates (server → server_fastmcp) Updated all references from deprecated `server` module to `server_fastmcp`: **User-facing documentation:** - examples/http_transport_examples.sh: All 13 command examples - README.md: Configuration examples and troubleshooting commands - docs/guides/MCP_SETUP.md: Enhanced migration guide with stdio/HTTP examples - docs/guides/TESTING_GUIDE.md: Test import statements - docs/guides/MULTI_AGENT_SETUP.md: Updated examples - docs/guides/SETUP_QUICK_REFERENCE.md: Updated paths - CLAUDE.md: CLI command examples **MCP module:** - src/skill_seekers/mcp/README.md: Updated config examples - src/skill_seekers/mcp/agent_detector.py: Use server_fastmcp module Note: Historical release notes (CHANGELOG.md) preserved unchanged. ### 2. Venv Python Configuration **setup_mcp.sh improvements:** - Added automatic venv detection (checks .venv, venv, and $VIRTUAL_ENV) - Sets PYTHON_CMD to venv Python path when available - **CRITICAL FIX**: Now updates PYTHON_CMD after creating/activating venv - Generates MCP configs with full venv Python path - Falls back to system python3 if no venv found - Displays detected Python version and path **Config examples updated:** - .claude/mcp_config.example.json: Use venv Python path - example-mcp-config.json: Use venv Python path - Added "type": "stdio" for clarity - Updated to use server_fastmcp module ### 3. Bug Fix: PYTHON_CMD Not Updated After Venv Creation Previously, when setup_mcp.sh created or activated a venv, it failed to update PYTHON_CMD, causing generated configs to still use system python3. **Fixed cases:** - When $VIRTUAL_ENV is already set → Update PYTHON_CMD to venv Python - When existing venv is activated → Set PYTHON_CMD="$REPO_PATH/venv/bin/python3" - When new venv is created → Set PYTHON_CMD="$REPO_PATH/venv/bin/python3" ## Benefits ### For Users: ✅ No deprecation warnings - All docs show current module ✅ Proper Python environment - MCP uses venv with all dependencies ✅ No system Python issues - Avoids "module not found" errors ✅ No global installation needed - No --break-system-packages required ✅ Automatic detection - setup_mcp.sh finds venv automatically ✅ Clean isolation - Projects don't interfere with system Python ### For Maintainers: ✅ Prepared for v3.0.0 - Documentation ready for server.py removal ✅ Reduced support burden - Fewer MCP configuration issues ✅ Consistent examples - All docs use same module/pattern ## Testing **Verified:** - ✅ All command examples use server_fastmcp - ✅ No deprecated module references in user-facing docs (0 results) - ✅ New module correctly referenced (129 instances) - ✅ setup_mcp.sh detects venv and generates correct config - ✅ PYTHON_CMD properly updated after venv creation - ✅ MCP server starts correctly with venv Python **Files changed:** 12 files (+262/-107 lines) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> |
||
yusyus
|
9e41094436 |
feat: v2.4.0 - MCP 2025 upgrade with multi-agent support (#217)
* feat: v2.4.0 - MCP 2025 upgrade with multi-agent support Major MCP infrastructure upgrade to 2025 specification with HTTP + stdio transport and automatic configuration for 5+ AI coding agents. ### 🚀 What's New **MCP 2025 Specification (SDK v1.25.0)** - FastMCP framework integration (68% code reduction) - HTTP + stdio dual transport support - Multi-agent auto-configuration - 17 MCP tools (up from 9) - Improved performance and reliability **Multi-Agent Support** - Auto-detects 5 AI coding agents (Claude Code, Cursor, Windsurf, VS Code, IntelliJ) - Generates correct config for each agent (stdio vs HTTP) - One-command setup via ./setup_mcp.sh - HTTP server for concurrent multi-client support **Architecture Improvements** - Modular tool organization (tools/ package) - Graceful degradation for testing - Backward compatibility maintained - Comprehensive test coverage (606 tests passing) ### 📦 Changed Files **Core MCP Server:** - src/skill_seekers/mcp/server_fastmcp.py (NEW - 300 lines, FastMCP-based) - src/skill_seekers/mcp/server.py (UPDATED - compatibility shim) - src/skill_seekers/mcp/agent_detector.py (NEW - multi-agent detection) **Tool Modules:** - src/skill_seekers/mcp/tools/config_tools.py (NEW) - src/skill_seekers/mcp/tools/scraping_tools.py (NEW) - src/skill_seekers/mcp/tools/packaging_tools.py (NEW) - src/skill_seekers/mcp/tools/splitting_tools.py (NEW) - src/skill_seekers/mcp/tools/source_tools.py (NEW) **Version Updates:** - pyproject.toml: 2.3.0 → 2.4.0 - src/skill_seekers/cli/main.py: version string updated - src/skill_seekers/mcp/__init__.py: 2.0.0 → 2.4.0 **Documentation:** - README.md: Added multi-agent support section - docs/MCP_SETUP.md: Complete rewrite for MCP 2025 - docs/HTTP_TRANSPORT.md (NEW) - docs/MULTI_AGENT_SETUP.md (NEW) - CHANGELOG.md: v2.4.0 entry with migration guide **Tests:** - tests/test_mcp_fastmcp.py (NEW - 57 tests) - tests/test_server_fastmcp_http.py (NEW - HTTP transport tests) - All existing tests updated and passing (606/606) ### ✅ Test Results **E2E Testing:** - Fresh venv installation: ✅ - stdio transport: ✅ - HTTP transport: ✅ (health check, SSE endpoint) - Agent detection: ✅ (found Claude Code) - Full test suite: ✅ 606 passed, 152 skipped **Test Coverage:** - Core functionality: 100% passing - Backward compatibility: Verified - No breaking changes: Confirmed ### 🔄 Migration Path **Existing Users:** - Old `python -m skill_seekers.mcp.server` still works - Existing configs unchanged - All tools function identically - Deprecation warnings added (removal in v3.0.0) **New Users:** - Use `./setup_mcp.sh` for auto-configuration - Or manually use `python -m skill_seekers.mcp.server_fastmcp` - HTTP mode: `--http --port 8000` ### 📊 Metrics - Lines of code: 2200 → 300 (87% reduction in server.py) - Tools: 9 → 17 (88% increase) - Agents supported: 1 → 5 (400% increase) - Tests: 427 → 606 (42% increase) - All tests passing: ✅ 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> * fix: Add backward compatibility exports to server.py for tests Re-export tool functions from server.py to maintain backward compatibility with test_mcp_server.py which imports from the legacy server module. This fixes CI test failures where tests expected functions like list_tools() and generate_config_tool() to be importable from skill_seekers.mcp.server. All tool functions are now re-exported for compatibility while maintaining the deprecation warning for direct server execution. * fix: Export run_subprocess_with_streaming and fix tool schemas for backward compatibility - Add run_subprocess_with_streaming export from scraping_tools - Fix tool schemas to include properties field (required by tests) - Resolves 9 failing tests in test_mcp_server.py * fix: Add call_tool router and fix test patches for modular architecture - Add call_tool function to server.py for backward compatibility - Fix test patches to use correct module paths (scraping_tools instead of server) - Update 7 test decorators to patch the correct function locations - Resolves remaining CI test failures --------- Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com> |