使用说明内容（Markdown格式）

• 项目简介 ADAM 项目实现一个可运行的 MCP 服务器体系，采用 FastMCP 构建一个主服务器，并挂载多个子服务器（如汇率、时间、股票、天气、新闻、家居传感器等工具）以对外提供标准的 MCP 服务接口。客户端通过 JSON-RPC 与之通信，可读取资源、执行工具调用、获取提示模板等上下文信息。

• 主要功能点

  • 主服务器：通过 FastMCP 提供 MCP 服务，负责会话管理、能力声明以及路由子服务。
  • 子服务（工具集）：独立的 MCP 服务实例，暴露诸如货币汇率、时间、股票数据、天气、新闻和家居传感器等工具。每个子服务注册一个前缀（如 c_、t_、s_、w_、n_、h_），供 MCP 客户端在调用工具时进行路径解析。
  • 跨模块组合：主服务器将各子服务按前缀挂载，使得客户端能够通过统一入口访问不同领域的工具。
  • 安全与部署：支持 CORS、中间件等；通过环境变量进行配置，适合 Docker Compose 部署。

• 安装步骤

  1. 确保依赖环境：Docker、Docker Compose、Python 环境。
  2. 配置环境变量与依赖
     • 根据 README 提示，在 adk、mcp-server 目录下创建并编辑 .env 文件，确保包括 mcp_server_url、相关 API Key 等。
  3. 启动应用
     • 使用 docker compose 启动整套服务（README 中给出命令）。
  4. 访问服务
     • MCP 服务器默认监听并暴露接口，示例地址：http://localhost:8001（请以实际运行时端口为准）。
  5. 停止应用
     • 使用 docker-compose down 或相应的容器管理命令。

• 服务器配置（MCP 客户端配置示例，JSON 格式，注意：客户端配置仅用于说明，不是仓库代码的一部分） { "server_name": "AdamMCP", "command": "python", "args": ["mcp-server/server.py"] // 说明：启动主 MCP 服务器进程的命令及参数。实际端口和部署方式以运行环境为准，客户端本身不需要在此处提供实现细节。 }

• 基本使用方法

  • 运行与连接：启动 ADAM 的 MCP 服务器集群后，MCP 客户端通过 JSON-RPC 以规范请求方式访问资源、调用工具与渲染提示模板。
  • 调用工具的路径前缀举例：在客户端通过前缀访问不同工具，例如汇率工具前缀为 c_，时间工具前缀为 t_ 等，具体请求格式遵循 MCP 的 JSON-RPC 规范。
  • 会话与能力：服务器对话上下文、工具能力等由 MCP 服务端管理，客户端无需实现底层协议栈，遵循标准 Json-RPC 调用格式即可。