Jactus MCP

JACTUS MCP服务器

独立MCP服务器 贾图斯 --使Claude Code等人工智能助手能够直接访问JACTUS金融合约模拟功能。

这是什么？

安装

pip install jactus-mcp

这将安装MCP服务器并拉取 jactus 作为自动依赖。

下载文档和示例

安装后，可选择从GitHub下载JACTUS文档和示例：

jactus-mcp setup

这将下载匹配版本的 docs/ 和 examples/ 进入 ~/.jactus-mcp/data/。您还可以指定一个标签：

jactus-mcp setup --tag v0.2.0   # specific version
jactus-mcp setup --force         # re-download
jactus-mcp status                # check what's downloaded
jactus-mcp clean                 # remove downloaded data

来自GitHub

pip install git+https://github.com/pedronahum/JACTUS-MCP.git

为了发展

git clone https://github.com/pedronahum/JACTUS-MCP.git
cd JACTUS-MCP
pip install -e ".[dev]"

配置

克劳德代码

添加到您的Claude Code MCP设置中(.mcp.json 或设置）：

{
  "mcpServers": {
    "jactus": {
      "command": "jactus-mcp"
    }
  }
}

或者使用Python模块：

{
  "mcpServers": {
    "jactus": {
      "command": "python",
      "args": ["-m", "jactus_mcp"]
    }
  }
}

克劳德桌面版

添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "jactus": {
      "command": "jactus-mcp"
    }
  }
}

运输选项

# Default: stdio transport (for local clients)
jactus-mcp
# or
python -m jactus_mcp

# Streamable HTTP transport (for remote clients)
python -m jactus_mcp --transport streamable-http

特性

核心工具（始终可用）

这些工具仅适用于 pip install jactus-mcp --不需要源树：

文档和示例工具（需要设置）

这些工具需要JACTUS文档/示例。通过以下方式启用它们 jactus-mcp setup:

或者，指向当地的JACTUS结账处：

export JACTUS_ROOT=/path/to/JACTUS

MCP资源

MCP提示

快速示例

在MCP服务器运行时，问Claude：

“模拟一笔10万美元的PAM贷款，利率为5%，1年内到期”

克劳德将：

1. 呼叫 jactus_get_contract_schema("PAM") 获取必填字段
2. 呼叫 jactus_simulate_contract 与属性
3. 返回结构化现金流事件（IED、IP、MD）及其支付金额

合同类型

JACTUS实现了所有18种ACTUS合约类型：

• 本金：帕姆、林、拉克斯、南、安、克莱姆
• 非主要负责人：UMP、CSH、STK
• 异域的：COM
• 衍生品：外汇输出、期权、期货、主权财富投资组合、掉期、资本充足率、CEG、CEC

发展

运行测试

# Unit tests
pytest tests/ -v --ignore=tests/test_mcp_integration.py

# Integration tests (requires MCP stdio client)
pytest tests/test_mcp_integration.py -v

# All tests
pytest tests/ -v

建筑

JACTUS-MCP/
├── src/jactus_mcp/
│   ├── __init__.py            # Package version
│   ├── __main__.py            # python -m jactus_mcp entry point
│   ├── server.py              # FastMCP server (tools, resources, prompts)
│   ├── models.py              # Pydantic response models
│   └── tools/
│       ├── _utils.py          # Shared utilities (get_jactus_root, type conversion)
│       ├── contracts.py       # Contract discovery & schema (18 types)
│       ├── simulate.py        # Contract simulation
│       ├── examples.py        # Example retrieval & execution
│       ├── validation.py      # Attribute validation
│       ├── documentation.py   # Documentation search & topic guides
│       ├── risk.py            # Risk analytics (DV01, delta, gamma)
│       └── system.py          # Health checks & version info
├── tests/                     # Comprehensive test suite
├── pyproject.toml             # Package configuration
└── README.md

许可证

Apache许可证2.0

链接

• JACTUS图书馆
• 模型上下文协议
• 克劳德代码