TITAN MCP 服务器实现
使用说明(Markdown 格式)
-
项目简介 TITAN MCP 服务器实现一个基于 MCP 的后端服务,能够向客户端提供资源管理、工具注册与执行、以及提示模板渲染能力。该实现包含一个 Yahoo Finance 的 MCP 服务器,向 LLM 客户端暴露股票价格查询和公司信息查询等工具。
-
主要功能点
- MCP 服务器实现:通过 FastMCP 框架搭建,暴露工具供 MCP 客户端调用。
- 工具注册与封装:服务器实现了 get_stock_price 与 get_company_info 两个工具,并允许通过标准化接口被客户端调用。
- 客户端交互示例:提供基于 JSON-RPC 风格的请求与响应流程,便于 LLM 客户端通过 MCP 获取外部能力。
- 异步与并发支持:服务端代码采用异步模式,兼容现代后端并发处理。
- 与现有系统的集成能力:与 TITAN 平台中的 MCP 客户端、数据存储和日志系统等组件协同工作。
-
安装步骤
- 确保 Python 环境就绪,并安装所需依赖。
- 启动 MCP 服务器(YahooFinance): python app/mcp/finance_server.py
- 启动后端的 Titan 服务以与 MCP 服务对接(根据项目文档的常规启动方式执行相应命令)。
- MCP 客户端配置好后即可通过标准化接口调用服务器暴露的工具。
-
服务器配置(MCP 客户端无需关注,以下信息供 MCP 客户端理解服务器端配置) 配置示例(JSON 格式): { "server_name": "YahooFinance", "command": "python", "args": ["app/mcp/finance_server.py"], "description": "MCP 服务器,暴露 Yahoo Finance 工具集,包括获取股票价格与公司信息等能力。" } 注释说明:
- server_name 表示 MCP 服务器在客户端侧的识别名称,与实现中的 FastMCP 实例名称相对应。
- command 指定启动服务器的命令阐述,一般为解释器路径或可执行程序。
- args 给出启动服务器所需的参数列表,此处指向 finance_server.py。
- description 旨在简要描述该 MCP 服务器提供的能力,方便客户端识别与注册工具。
-
基本使用方法
- 客户端通过 JSON-RPC 调用与 MCP 服务器交互,获取工具清单、调用工具并接收结果。
- 开发者可在 LLM 调用中将工具结果回传给生成模块,完成组合式推理与外部数据接入。
- 服务器具备容错能力,若工具调用失败会返回错误信息,客户端可按需重试或回退。
-
备注
- 该实现包含一个 Yahoo Finance 的 MCP 服务端,工具包括获取股票价格与公司信息两个功能。
- 如需扩展更多金融工具,只需在服务器中添加新的工具并进行注册即可。