tellermcp-mcp

公开 Teller delta 中性 + 借贷模型上下文协议服务器。当您需要安装、运行或更新 Tellermcp MCP 后端时，请使用此选项，以便代理可以为 Teller 获取机会、借用条款和链上交易构建器。

# Tellermcp MCP Skill

## Overview
This skill bundles a ready-to-run MCP server (`scripts/tellermcp-server/`) that surfaces Teller delta-neutral arbitrage data, borrow pool discovery, loan terms, borrow transaction builders, and repayment helpers. Load this skill whenever you must:
- Deploy or modify the Tellermcp MCP server
- Re-run `npm install`, build, or tests for the server
- Register Tellermcp with mcporter/OpenClaw so agents can hit the Teller APIs via MCP tools

## Quick Start
1. `cd scripts/tellermcp-server`
2. `npm install`
3. (Optional) Configure env vars:
   - `TELLER_API_BASE_URL` (defaults to `https://delta-neutral-api.teller.org`)
   - `TELLER_API_TIMEOUT_MS` (defaults to `15000` ms)
4. `npm run build` → TypeScript type-check.
5. `npm start` → launches `tellermcp` MCP server over stdio.

## Repo Layout (`scripts/tellermcp-server/`)
- `package.json` / `package-lock.json` – Node 20+ project metadata
- `tsconfig.json` – ES2022/ESNext build targets
- `src/client.ts` – Typed Teller REST client (fetch wrapper + filters)
- `src/types.ts` – TypeScript interfaces for all Teller responses
- `src/index.ts` – MCP server wiring (McpServer + StdioServerTransport) registering tools:
  1. `get-delta-neutral-opportunities`
  2. `get-borrow-pools`
  3. `get-borrow-terms`
  4. `build-borrow-transactions`
  5. `get-wallet-loans`
  6. `build-repay-transactions`

Each tool returns: short text summary + `structuredContent.payload` containing the raw JSON for downstream automation.

## Runbook
### Installing dependencies
```bash
cd scripts/tellermcp-server
npm install
```
The project intentionally omits `node_modules/` & `dist/`; `npm install` and `npm run build` regenerate them.

### Local testing
- `npm run build` → TypeScript compile.
- `npm start` → STDIO MCP server. Use `gh pr checks` or `npm test` (placeholder) if additional tests are added later.

### Registering with mcporter / OpenClaw
Add an entry to your `mcporter` (or agent transport) config:
```jsonc
{
  "name": "tellermcp",
  "command": "npm",
  "args": ["start"],
  "cwd": "/absolute/path/to/scripts/tellermcp-server"
}
```
Once mcporter restarts, Codex agents can invoke the six Teller tools directly.

### Deploying updates
1. Edit TypeScript files inside `src/`.
2. `npm run build` locally.
3. Commit + push via GitHub skill (if syncing to `teller-protocol/teller-mcp`).
4. Restart the mcporter process pointing at this repo to pick up changes.

## References
- [references/delta-neutral-api.md](references/delta-neutral-api.md) – condensed Teller API cheat sheet (endpoints, params, caching behavior). Load when you need exact REST contract details.

## Packaging This Skill
When ready to ship a `.skill` bundle:
```bash
python3 /usr/local/lib/node_modules/openclaw/skills/skill-creator/scripts/package_skill.py /data/workspace/skills/tellermcp-mcp
```
The packager validates SKILL.md + resources and emits `tellermcp-mcp.skill` (zip) for distribution.

---

## 中文说明

# Tellermcp MCP 技能

## 概述
此技能打包了一个开箱即用的 MCP 服务器（`scripts/tellermcp-server/`），用于呈现 Teller 的 delta 中性套利数据、借贷池发现、贷款条款、借贷交易构建器以及还款辅助工具。在你需要执行以下操作时加载此技能：
- 部署或修改 Tellermcp MCP 服务器
- 重新运行服务器的 `npm install`、构建或测试
- 将 Tellermcp 注册到 mcporter/OpenClaw，以便代理可通过 MCP 工具访问 Teller API

## 快速开始
1. `cd scripts/tellermcp-server`
2. `npm install`
3.（可选）配置环境变量：
   - `TELLER_API_BASE_URL`（默认为 `https://delta-neutral-api.teller.org`）
   - `TELLER_API_TIMEOUT_MS`（默认为 `15000` 毫秒）
4. `npm run build` → TypeScript 类型检查。
5. `npm start` → 通过 stdio 启动 `tellermcp` MCP 服务器。

## 仓库结构（`scripts/tellermcp-server/`）
- `package.json` / `package-lock.json` – Node 20+ 项目元数据
- `tsconfig.json` – ES2022/ESNext 构建目标
- `src/client.ts` – 类型化的 Teller REST 客户端（fetch 封装 + 过滤器）
- `src/types.ts` – 所有 Teller 响应的 TypeScript 接口
- `src/index.ts` – MCP 服务器接线（McpServer + StdioServerTransport），注册以下工具：
  1. `get-delta-neutral-opportunities`
  2. `get-borrow-pools`
  3. `get-borrow-terms`
  4. `build-borrow-transactions`
  5. `get-wallet-loans`
  6. `build-repay-transactions`

每个工具返回：简短的文本摘要 + 包含原始 JSON 的 `structuredContent.payload`，用于下游自动化。

## 操作手册
### 安装依赖
```bash
cd scripts/tellermcp-server
npm install
```
该项目有意省略了 `node_modules/` 和 `dist/`；`npm install` 和 `npm run build` 会重新生成它们。

### 本地测试
- `npm run build` → TypeScript 编译。
- `npm start` → STDIO MCP 服务器。如果以后添加了额外测试，可使用 `gh pr checks` 或 `npm test`（占位符）。

### 注册到 mcporter / OpenClaw
在你的 `mcporter`（或代理传输）配置中添加一个条目：
```jsonc
{
  "name": "tellermcp",
  "command": "npm",
  "args": ["start"],
  "cwd": "/absolute/path/to/scripts/tellermcp-server"
}
```
mcporter 重启后，Codex 代理即可直接调用这六个 Teller 工具。

### 部署更新
1. 编辑 `src/` 内的 TypeScript 文件。
2. 在本地运行 `npm run build`。
3. 通过 GitHub 技能提交并推送（如果同步到 `teller-protocol/teller-mcp`）。
4. 重启指向此仓库的 mcporter 进程以应用更改。

## 参考资料
- [references/delta-neutral-api.md](references/delta-neutral-api.md) – 精简版 Teller API 速查表（端点、参数、缓存行为）。当你需要精确的 REST 契约细节时加载。

## 打包此技能
当准备好交付 `.skill` 包时：
```bash
python3 /usr/local/lib/node_modules/openclaw/skills/skill-creator/scripts/package_skill.py /data/workspace/skills/tellermcp-mcp
```
打包器会验证 SKILL.md + 资源，并生成用于分发的 `tellermcp-mcp.skill`（zip）。