使用说明内容(Markdown格式)

项目简介

  • NSSA AI Agent Platform 提供基于 MCP 协议的后端服务端实现,包含网络诊断 MCP、Gemini RAG MCP 等服务器,实现多 Agent 协同、工具统一调度、审计追踪等企业级能力。

主要功能点

  • MCP 服务核心:实现 MCP 服务器的基本接口,提供 list_tools 和 call_tool 等命令,以及通过 stdio/HTTP 等传输实现与客户端通信。
  • 多 MCP 服务器场景:内含 network-mcp、gemini-rag-mcp 等服务器实现,支持分布式工具执行和路由调度。
  • 与前端/中台协作:通过 ServerRegistry、ToolGateway、AuditLogger、LangGraph 等模块实现路由、审计、工具执行及对话流程管理。
  • 客户端集成能力:提供 McpClientManager、LangChainAdapter 等客户端适配层,便于将 MCP 服务端暴露的工具接入到 LangChain/LLM 流程中。
  • 热加载与可观测性:配置热加载、日志系统、Token 统计、执行历史压缩等,保障高可用性和可观测性。

安装与运行

  • 依赖与安装:克隆仓库后按照 README 指示安装依赖,推荐使用 uv(uv/uvx)运行相关 MCP 服务器。
  • 启动 MCP 服务器:
    • 通过 uvx 启动网络诊断 MCP,例如:uvx mcp-server-network
    • 通过 uvx 启动 Gemini RAG MCP,例如:uvx mcp-server-gemini_rag
  • 客户端准备:MCP 客户端需要的仅是一个包含 MCP 服务器启动命令和参数的配置(如 server name、command、args),以便与 MCP 服务器建立连接与调用工具。

服务器配置示例(提供给 MCP 客户端的配置信息,非代码块描述,便于理解) { "mcp_servers": [ { "name": "network-mcp", "command": "uvx", "args": ["mcp-server-network"], "tools_prefix": "network" }, { "name": "gemini-rag-mcp", "command": "uvx", "args": ["mcp-server-gemini_rag"], "tools_prefix": "gemini_rag" } ] } 说明:

  • name: MCP 服务器名称,便于在客户端进行注册、路由和请求调度
  • command: 启动 MCP 服务器的命令(示例中使用 uvx,实际请按环境部署方式调整)
  • args: 启动参数,通常包含要加载的服务器模块/入口
  • tools_prefix: 工具前缀,用于工具绑定及自动路由

基本使用方法

  • 客户端连接与调用:MCP 客户端通过标准化 JSON-RPC/工具调用接口,向指定 MCP 服务器请求资源、调用工具、获取 Prompts 等。
  • 路由与执行:Router/Graph/Act 组件负责任务分解、路由分发到相应的 MCP 服务器执行工具,返回观察和最终结果。
  • 监控与审计:AuditLogger 记录每次工具调用的详细信息,方便追踪与审计。
  • 热加载与扩展:配置热加载、动态添加/移除服务器与工具,便于运维与扩展。

关键词 Model Context Protocol, LangGraph, 多代理协作, 工具网关, 网络诊断

分类ID 6

信息

分类

AI与计算