EstateWise MCP 服务器

使用说明

• 项目简介 EstateWise MCP 服务器是一个完整的 MCP 后端实现，负责以标准化方式向 MCP 客户端提供上下文数据、可执行的工具、以及可渲染的 Prompt 模板，帮助 LLM 客户端统一访问数据、执行外部功能并生成合成响应。服务器通过 JSON-RPC 与客户端通信，具备会话管理、能力声明以及对多种传输协议的支持能力。

• 主要功能点

  • 资源与数据管理：托管与访问各类数据资源，为 LLM 提供数据访问能力。
  • 工具注册与执行：注册并注册外部工具，LLM 客户端可调用服务器端工具执行外部功能。
  • 提示模板与渲染：定义与渲染 Prompt 模板，支持多种交互模式。
  • A2A 桥接：实现 Agent-to-Agent 的任务协作与信息流转。
  • 会话与能力声明：管理会话、能力声明，以及对外暴露的工具集与资源集合。
  • 传输协议支持：通过 stdio、SSE、WebSocket 等传输协议与 MCP 客户端通信，确保实时性与扩展性。
  • 安全与观测：内置日志、错误处理、以及对工具调用的观测能力（可扩展的监控与告警）。

• 安装步骤

  1. 将仓库克隆到本地，进入 MCP 相关目录：
     • 进入 mcp 目录（EstateWise-Chapel-Hill-Chatbot/mcp）。
  2. 安装依赖并编译：
     • 运行安装命令安装依赖；随后执行构建命令（如有构建步骤）。
  3. 启动 MCP 服务器：
     • 使用提供的启动命令在本地启动 MCP 服务器，例如通过 dev/start 脚本启动。
  4. 配置环境与客户端：
     • 根据项目文档复制并调整 mcp/.env（如 API_BASE、A2A_BASE_URL 等环境变量）。
     • MCP 客户端需要通过配置文件提供启动参数（serverName、command、args 等），以连接到 MCP 服务器。
  5. 测试与对接：
     • 使用示例客户端对 MCP 服务器进行工具查询与调试，确保资源、工具、以及 Prompts 能被正确调用并返回结果。

• 服务器配置（MCP 客户端所需的 JSON 配置示例，客户端无需部署代码，仅用于说明配置要点） { "serverName": "EstateWise-MCP-Server", "command": "node", "args": ["dist/server.js"], "transport": "stdio", "description": "EstateWise 的 MCP 服务器，提供资源、工具与提示模板的 MCP 接口", "workingDirectory": "mcp", "notes": "该配置用于 MCP 客户端启动时连接到 MCP 服务器；具体路径与启动命令以实际部署为准" }

  参数注释说明：

  • serverName：用于标识 MCP 服务器的名称，便于在多服务器环境中区分。
  • command：启动 MCP 服务器所用的命令（例如 node、tsx 等）。
  • args：启动命令的参数，指向服务器入口文件（如 dist/server.js）。
  • transport：传输协议，stdio 表示通过标准输入输出进行通讯，客户端应使用相同的传输机制。
  • description/workingDirectory/notes：用于说明与定位服务器的元信息，便于运维与协作。 说明：MCP 客户端不需要在此输出中包含具体实现代码，配置仅用于启动连接 MCP 服务器。

• 基本使用方法

  1. 启动 MCP 服务器后，MCP 客户端通过 JSON-RPC 向服务器发起请求，获取资源、执行工具、获取 Prompts 等。
  2. 客户端可以通过工具接口调用注册在服务器上的工具，并接收执行结果与相应的上下文信息。
  3. 使用者可通过日志、监控与错误信息追踪请求的执行情况与性能指标。
  4. 若需要跨代理协作（A2A），客户端通过 A2A 接口进行任务分发与结果聚合，提升多模态/多模型协作的能力。

• 重要注意

  • MCP 服务器是面向 MCP 客户端的后端服务，客户端需要提供启动配置（包含 serverName、command、args 等信息）来建立与 MCP 服务器的连接。
  • 具体 API、工具名称、资源地址等将在 MCP 文档中给出详细规范，请遵循官方文档进行开发与对接。