VKKM Aegis MCP Server

关键词

ClaudeJSON-RPCMonte Carlo风险管理实时数据

使用说明（Markdown 格式，便于快速上手）:

  • 项目简介 VKKM Aegis MCP 服务器是一个实现 MCP 协议的后端服务，旨在向 LLM 客户端（如 Claude）提供统一的上下文能力，包括

    • 资源管理与数据访问
    • 工具注册与执行（例如 Monte Carlo VaR、Black-Scholes Greeks、Z-Score、信用风险等）
    • 提示模板的获取与渲染 服务器通过 JSON-RPC（以及可选的传输方式如 Stdio）与客户端通信，负责请求路由、会话与能力声明，便于在本地或私有云环境中运行量化模型与数据处理。

  • 主要功能点

    1. 工具注册与执行：将多种量化工具暴露给客户端，支持参数校验和结构化输入/输出。工具列表包括 monte_carlo_var、greeks、credit_risk、liquidity、zscore、ml_pd、plot_monte_carlo、sentiment_analysis、crypto_risk、generate_pitchbook 等等。
    2. 后端计算引擎对接：执行请求时会将参数转发到位于后端的计算服务（Node 连接器通过 JSON-RPC 将请求映射到后端 API，Python FastAPI 提供实际计算端点如 /monte-carlo、/greeks 等）。
    3. 数据源与导出：支持 SQL 端口直接从企业数据库获取投资组合数据、以及导出为 Excel/JSON/PDF 的能力，便于董事会汇报与风险管理文档编制。
    4. 多传输与部署模式：Node.js 实现的 MCP 连接器通过 stdio 传输与 Claude Desktop 直接连接；同时独立的 Python MCP 后端可通过 HTTP/FastAPI 提供计算端点（后端分离、便于安全隔离）。
    5. 安全与可扩展性：设计强调本地计算、零数据外传、以及可扩展的工具集成，适用于企业级风险管理场景。

  • 安装与运行（简要）

    • Node 版本的 MCP 连接器（index.js）可通过 Node.js 运行，通常作为一个独立的 stdio 服务被 Claude Desktop 调用（在 Claude 配置中以 command: "npx", args: ["-y","vkkm-aegis"] 的方式接入）。
    • Python 版本的 MCP 后端（mcp_server.py）通过 FastAPI 提供 HTTP API，通常搭配 uvicorn 启动。两者可按需组合使用，Node 负责与客户端的 MCP 协议对接，Python 端点执行具体计算。

  • 服务器配置（供 MCP 客户端使用的启动信息） 下面的配置用于 Claude 客户端连接该 MCP 服务器（以 Node.js 版本的 stdio 服务为例）： { "server_name": "vkkm-aegis", "command": "npx", "args": ["-y", "vkkm-aegis"], "transport": "stdio", "notes": "Node.js MCP连接器，启动后将通过标准输入/输出与 Claude 客户端通信；后端实际计算可通过后端 API（默认 https://vaibhavkkm-vkkm-aegis.hf.space）完成。" }

  • 基本使用方法

    1. 启动 MCP 服务器端
      • Node 连接器: 直接通过命令行执行可启动， Claude Desktop 将通过配置自动加载该服务器。
      • Python 后端（可选）: 通过 uvicorn 运行 mcp_server:app，监听端口用于计算端点（如 /monte-carlo、/greeks 等）。
    2. 配置客户端连接
      • 在 Claude Desktop 的设置中，将服务器配置为名称为 vkkm-aegis 的 MCP 服务器，命令与参数如上配置示例所示。
    3. 发送请求
      • 客户端发送 JSON-RPC 请求给 MCP 服务器，请求包含工具名称、输入参数等，服务器返回计算结果或错误信息。
    4. 使用与输出
      • 工具执行结果通常以文本、JSON、或图片（如 Base64 编码的图像）形式返回，便于在对话中显示或进一步处理。
    5. 维护与扩展
      • 服务器端可新增工具、扩展数据源、以及新的导出格式，保持与后端计算服务的解耦，方便企业级扩展与审计。

  • 备注

    • 该仓库同时包含 Node.js MCP 连接器和 Python FastAPI 后端实现；实际生产环境可按需求将两者结合使用以获得更强的安全与可扩展性。
    • MCP 客户端需要的只是在启动时正确配置命令与参数，以及确保后端服务可访问（网络权限与认证策略可按企业要求设定）。

服务器信息

访问项目