使用说明(简要易懂的操作指南,包含关键要点)
-
项目简介
- 该仓库实现一个 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 客户端使用的,用来描述如何连接并启动 MCP 服务器。以下为示例配置要素(以 JSON 形式表现,供理解用途,不放在代码块内,便于非开发者阅读):
-
基本使用方法
- 启动后,客户端可通过 MCP 协议向服务器发起工具调用、获取资源、或请求提示模板等。
- 客户端可通过提供会话ID来维持会话状态,服务器会基于会话信息进行鉴权与数据访问控制。
- 如需扩展,开发者可在 pkg.ToolList 中添加新的 ToolInfo,以及在代码中实现对应的工具处理逻辑。
-
备注
- 参考实现中还包含测试数据目录 test_data_dir、简易的登录页面及中间件,方便演示与本地测试。
信息
分类
网页与API