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 客户端、数据存储和日志系统等组件协同工作。
  • 安装步骤

    1. 确保 Python 环境就绪,并安装所需依赖。
    2. 启动 MCP 服务器(YahooFinance): python app/mcp/finance_server.py
    3. 启动后端的 Titan 服务以与 MCP 服务对接(根据项目文档的常规启动方式执行相应命令)。
    4. 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 服务端,工具包括获取股票价格与公司信息两个功能。
    • 如需扩展更多金融工具,只需在服务器中添加新的工具并进行注册即可。

服务器信息