mirror of
https://github.com/GNS3/gns3-server.git
synced 2026-11-19 20:55:14 +02:00
- Drop the unused fastmcp wrapper pin (mcp-requirements.txt) and depend on the official SDK directly: mcp>=2.3,<3. The code only ever imported mcp.server.* modules; fastmcp was pulled in solely as a dependency vehicle and its <4 pin kept mcp locked at 1.x. - Migrate to the SDK 2.x API: FastMCP -> MCPServer (mcp.server.mcpserver); transport_security moves from the constructor into streamable_http_app(). - Replace the deprecated SSE transport (spec-deprecated 2025-06-18) with Streamable HTTP at POST/GET/DELETE /v3/mcp/transport, mounted at /v3/mcp. - Run the StreamableHTTP session manager in the FastAPI lifespan (Starlette does not execute mounted sub-app lifespans), entered before startup finishes so no request passes the MCP ready gate first. - Authenticate every request (the SSE wrapper only checked the opening GET and trusted POSTs by session). Add a 5-minute TTL cache for API-key resolutions so the stricter per-request check does not cost a bcrypt round on every call. - Update docs to the new endpoint, auth flow, and client configuration. Wire-format verified unchanged against SDK 1.30 (structured output auto-detection and content conversion are byte-identical for the list[dict] returns used by all tool handlers).
108 lines
3.6 KiB
Python
108 lines
3.6 KiB
Python
#
|
|
# Copyright (C) 2025 GNS3 Technologies Inc.
|
|
#
|
|
# This program is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received copy of the GNU General Public License
|
|
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
"""
|
|
Agent module with optional AI Copilot and MCP support.
|
|
|
|
This module provides the AI Copilot and MCP (Model Context Protocol)
|
|
functionality as optional features. If the respective dependencies are
|
|
not installed, the affected features will be disabled but will not
|
|
prevent the server from starting.
|
|
|
|
Installation:
|
|
pip install gns3-server[ai-features] # Install all AI features
|
|
"""
|
|
|
|
import logging
|
|
import threading
|
|
|
|
# Feature flag: AI Copilot is available
|
|
AI_COPILOT_AVAILABLE = False
|
|
|
|
# Try to import AI Copilot components
|
|
try:
|
|
from .gns3_copilot.project_agent_manager import ProjectAgentManager, get_project_agent_manager
|
|
|
|
AI_COPILOT_AVAILABLE = True
|
|
|
|
# Start skills repository initialization in background.
|
|
# Clones/pulls GNS3-Skills during server startup.
|
|
# Git network timeouts are configured in SkillsManager (_GIT_TIMEOUT_ENV).
|
|
# The daemon thread auto-terminates when the process exits.
|
|
from gns3server.agent.gns3_copilot.skills.registry import _ensure_skills_manager
|
|
|
|
threading.Thread(target=_ensure_skills_manager, daemon=True).start()
|
|
|
|
except ImportError as e:
|
|
# AI dependencies not installed, disable AI Copilot feature
|
|
logging.warning(
|
|
f"AI Copilot dependencies not installed: {e}. "
|
|
"AI features will be disabled. "
|
|
"Install with: pip install gns3-server[ai-features]"
|
|
)
|
|
AI_COPILOT_AVAILABLE = False
|
|
|
|
# Provide stub functions that raise helpful errors
|
|
async def get_project_agent_manager() -> "ProjectAgentManager":
|
|
"""
|
|
Get the global ProjectAgentManager singleton instance.
|
|
|
|
Raises:
|
|
RuntimeError: If AI Copilot dependencies are not installed
|
|
"""
|
|
raise RuntimeError(
|
|
"AI Copilot is not available. Install AI dependencies with: pip install gns3-server[ai-features]"
|
|
)
|
|
|
|
class ProjectAgentManager: # type: ignore[no-redef]
|
|
"""
|
|
Stub class for ProjectAgentManager when AI dependencies are not installed.
|
|
"""
|
|
|
|
def __init__(self):
|
|
raise RuntimeError(
|
|
"AI Copilot is not available. Install AI dependencies with: pip install gns3-server[ai-features]"
|
|
)
|
|
|
|
|
|
# Feature flag: MCP (Model Context Protocol) is available
|
|
MCP_AVAILABLE = False
|
|
|
|
# Try to import MCP dependencies
|
|
try:
|
|
# Use importlib so the top-level SDK name "mcp" is not bound in this
|
|
# namespace — it would shadow the gns3server.agent.mcp subpackage.
|
|
import importlib
|
|
|
|
importlib.import_module("mcp.server.mcpserver")
|
|
MCP_AVAILABLE = True
|
|
except ImportError:
|
|
# MCP dependencies not installed, disable MCP feature
|
|
logging.warning(
|
|
"MCP dependencies not installed. "
|
|
"MCP features will be disabled. "
|
|
"Install with: pip install gns3-server[ai-features]"
|
|
)
|
|
MCP_AVAILABLE = False
|
|
|
|
|
|
__all__ = [
|
|
"AI_COPILOT_AVAILABLE",
|
|
"MCP_AVAILABLE",
|
|
"ProjectAgentManager",
|
|
"get_project_agent_manager",
|
|
]
|