使用说明
斜坡MCP服务器
用于与Ramp API集成的MCP服务器，由 迪达勒斯mcp framework。身份验证由处理 多思 （Dedalus Auth）-服务器从未看到原始API凭据。
先决条件
- Python 3.10或更高版本
- 具有API访问权限的Ramp帐户
- Ramp API承载令牌(
RAMP_TOKEN)连接到服务器时通过DAuth传递
安装
-
克隆或下载此存储库：
git clone <repository-url> cd ramp-mcp -
安装依赖项：
pip install -e .或者如果使用
uv:uv pip install -e .
配置
环境变量
复制示例并填写您的值：
cp .env.example .env
| 变量 | 描述 |
|---|---|
DEDALUS_AS_URL |
Dedalus授权服务器URL（默认值： https://as.dedaluslabs.ai) |
DEDALUS_API_KEY |
您的Dedalus平台API密钥 |
DEDALUS_API_URL |
Dedalus API URL（默认值： https://api.dedaluslabs.ai) |
RAMP_TOKEN |
您的Ramp API承载令牌（由客户端通过DAuth传递） |
身份验证（DAuth）
服务器接收Ramp Bearer令牌(RAMP_TOKEN)通过Dedalus Auth。当客户端连接时，它通过DAuth提供这个秘密；服务器使用 ctx.dispatch() 以通过DAuth飞地路由所有API调用。令牌永远不会暴露给服务器代码。
可用工具
所有工具都通过DAuth发出经过身份验证的请求。每个工具都接受可选 limit 和 start 分页参数。
核心工具
| 工具 | 描述 | 范围 |
|---|---|---|
read_transaction |
读取交易记录 | transactions:read |
read_merchant |
读取商家（可按以下条件过滤 merchant_name) |
merchants:read |
read_reimbursement |
阅读报销 | reimbursements:read |
read_user |
读取用户（可按以下条件筛选 user_name) |
users:read |
read_card |
阅读卡片 | cards:read |
read_bill |
阅读账单 | bills:read |
read_receipt |
读取收据 | receipts:read |
read_limit |
阅读支出限额 | limits:read |
read_vendor |
读取供应商（可按以下条件筛选 vendor_name) |
vendors:read |
read_department |
阅读部门 | departments:read |
read_location |
读取位置 | locations:read |
金融工具
| 工具 | 描述 | 范围 |
|---|---|---|
read_cashback |
阅读现金返还 | cashbacks:read |
read_statement |
阅读声明 | statements:read |
read_transfer |
读取传输 | transfers:read |
read_business |
阅读商业信息 | business:read |
read_repayment |
阅读还款 | repayments:read |
read_treasury |
读取资金信息 | treasury:read |
管理工具
| 工具 | 描述 | 范围 |
|---|---|---|
read_spend_program |
阅读支出计划 | spend_programs:read |
read_trip |
阅读旅行 | trips:read |
read_accounting |
读取会计信息 | accounting:read |
read_bank_account |
读取银行账户 | bank_accounts:read |
read_bank_feed |
读取银行订阅源 | bank_feeds:read |
read_memo |
阅读备忘录 | memos:read |
read_purchase_order |
读取采购订单 | purchase_orders:read |
read_receipt_integration |
读取收据集成 | receipt_integrations:read |
read_item_receipt |
读取商品收据 | item_receipts:read |
read_entity |
读取实体 | entities:read |
read_external_attendee |
阅读外部与会者 | external_attendees:read |
read_lead |
阅读潜在客户 | leads:read |
read_attendee_type |
阅读与会者类型 | attendee_types:read |
read_audit_log |
读取审核日志 | audit_logs:read |
read_custom_record |
读取自定义记录 | custom_records:read |
运行服务器
启动MCP服务器：
python -m src.main
服务器在端口8080上启动。与测试客户端验证：
python -m src.client
更新 src/client.py 使用正确的参数按名称调用您的工具。
项目结构
ramp-mcp/
├── src/
│ ├── __init__.py
│ ├── main.py # MCP server entry point and DAuth connection
│ ├── tools.py # Ramp API tool implementations
│ └── client.py # Test client for verifying tools
├── .env.example # Environment variable template
├── pyproject.toml # Project configuration and dependencies
├── LICENSE
└── README.md
安全说明
- 永不承诺
.env到版本控制 - 所有API调用都通过DAuth飞地-您的服务器代码从不接触原始凭据
- 如果您的凭据被泄露，请进行轮换
额外资源
许可证
有关详细信息，请参阅LICENSE文件。
