使用说明（概要）:

• 项目简介
  • 这是一个完整的 MCP 服务器实现，聚合多源金融数据、工具与提示模板，向 LLM 客户端提供标准化的资源访问、工具执行和提示渲染能力，具备会话管理和能力声明，且通过 JSON-RPC/HTTP 等协议与客户端通信。
• 主要功能点
  • 资源与数据源（Resources）：KAP、Yahoo Finance、TEFAS、BtcTurk、Coinbase、Doviz.com、TCMB 等多源数据接入，覆盖股票、指数、外汇、大宗商品、基金等。
  • 工具（Tools）：支持股票/US 市场数据、KAP 新闻、KAP/Haber、端到端基本面与技术分析工具、US/全球股票与基金相关分析工具等，支持单点查询与多点并行查询。
  • 提示模板与渲染（Prompts）：内置系统提示，协助 LLM 在对话中使用一致的分析框架、风险管理和投资哲学。
  • MCP 协议与 JSON-RPC：以 MCP 规范提供请求-响应模型，推荐使用 JSON-RPC 进行调用与通知。
  • 会话与能力声明：实现会话管理、能力声明，以及对资源/工具/Prompts 的清晰边界。
  • 多传输支持与缓存：通过中间件实现响应缓存，提升性能，并可扩展到多种传输协议（如 Stdio/SSE/WebSocket 等）。
• 安装与运行
  • 依赖与环境：请在 Python 环境中安装所需依赖（FastMCP、FastAPI、Pydantic、SQLAlchemy、requests 等，具体以项目中的依赖清单为准）。
  • 启动方式：使用如下方式启动 HTTP 服务，MCP 服务通过子应用挂载在 /mcp/ 路径：
    • 通过命令行启动：uvicorn asgi_app:app --host 0.0.0.0 --port 8000
  • 使用注意：默认配置下服务器会暴露在 0.0.0.0:8000，若在生产环境需结合反向代理与 TLS 进行安全加固。
• MCP 客户端配置（示例，JSON 格式，非代码）：
  • server name: BorsaMCP
  • command: uvicorn
  • args: ["asgi_app:app", "--host", "0.0.0.0", "--port", "8000"]
  • 说明：该配置用于 MCP 客户端连接此 MCP 服务器的启动命令与参数；客户端需要的仅是服务器地址和协议对接信息。本仓库还提供了系统提示、Discovery 接口等，用于对接 ChatGPT 等 MCP 客户端。
• 基本使用方法
  • 通过 MCP 客户端连接后，可调用工具来获取股票、基金、外汇、加密货币等数据，或查询 KAP 新闻、KAP/Haber、TEFAS 数据、US/全球市场数据等资源。
  • MCP 请求将返回标准的 JSON-RPC 风格响应，包含数据、错误信息或通知，便于 LLM 进行后续处理与分析。
  • 系统提示会提供统一的分析框架与 investimento 风险管理建议，帮助保持一致性与可解释性。
• 说明与扩展性
  • 服务器实现包含多源数据提供者、数据处理与分析工具、以及用于推理/对话的系统提示，具备良好的扩展性以接入额外的数据源、工具或新的 Prompts 模板。
  • 本实现包含本地部署、Remote MCP 使用、Claude Desktop 本地集成等场景的操作说明，便于不同环境部署与测试。