使用说明(简要易懂的操作指南,包含关键要点)

  • 项目简介

    • 该仓库实现一个 MCP 服务器,用 Go 语言编写,基于 mark3labs/mcp-go 框架,核心职责是向 LLM 客户端提供可访问的资源数据、可执行工具、以及可渲染的 Prompt 模板,便于构建以金融数据为中心的对话式应用。
  • 主要功能点

    • 资源管理与数据访问:通过内置数据源和测试数据目录,提供 net worth、账户、交易等相关数据支持。
    • 工具注册与执行:将一组工具(如 fetch_net_worth、fetch_bank_transactions 等)注册到 MCP 服务器,客户端可通过统一接口调用。
    • Prompt 与上下文:支持基于金融数据的上下文提示,帮助 LLM 给出更具针对性的回答。
    • 会话与中间件:内置认证中间件,基于会话 ID 实现简单的登录流程与权限校验。
    • JSON-RPC 通信:遵循 MCP 约定的请求/响应格式,客户端通过 JSON-RPC 与服务器交互。
    • 多传输/流式接口:提供可扩展的流式 HTTP 服务端,支持未来的 SSE/WebSocket 等传输方式。
  • 安装步骤

    • 环境要求:Go 1.x 及以上。
    • 步骤1:进入 MCP 服务器目录并安装依赖
      • cd fi-mcp-dev
      • go mod tidy
    • 步骤2:启动 MCP 服务器
      • go run .
    • 说明:默认服务器监听端口为 5001,初始示例地址为 http://localhost:5001
  • 服务器配置(MCP 客户端需要)

    • 配置是给 MCP 客户端使用的,用来描述如何连接并启动 MCP 服务器。以下为示例配置要素(以 JSON 形式表现,供理解用途,不放在代码块内,便于非开发者阅读):
      • server_name: "Fi-MCP 财务上下文服务器"
      • command: "go run ."
      • args: [] // 如需指定工作目录或参数,可在此添加
  • 基本使用方法

    • 启动后,客户端可通过 MCP 协议向服务器发起工具调用、获取资源、或请求提示模板等。
    • 客户端可通过提供会话ID来维持会话状态,服务器会基于会话信息进行鉴权与数据访问控制。
    • 如需扩展,开发者可在 pkg.ToolList 中添加新的 ToolInfo,以及在代码中实现对应的工具处理逻辑。
  • 备注

    • 参考实现中还包含测试数据目录 test_data_dir、简易的登录页面及中间件,方便演示与本地测试。

信息

分类

网页与API