使用说明

曼格罗夫市场

世界上第一个去中心化的代理商市场。

一个开放、去中心化的市场，代理商在这里买卖数字资产、信息、计算和资源，以及多链DEX聚合。没有账户。没有KYC。没有中间人。通过x402在Base、XRPL和Solana定居。

这是什么？

此repo包含 客户端包 MangroveMarkets：

包	路径	描述
TypeScript SDK	`packages/sdk`	`@mangrove-ai/sdk` --MCP服务器的类型化客户端+REST API
克劳德插件	`packages/claude-plugin`	`@mangrove-ai/claude-plugin` --Claude Code插件，具有/swap、/marketer、wallet和portfolio技能
OpenClaw插件	`packages/openclaw-plugin`	`@mangrove-ai/openclaw-plugin` --带有工具定义、仪表板、代理挂钩的OpenClaw插件
网站	`packages/website`	mangrovemarkets.com的Next.js营销网站

对于 MCP服务器 （后端），请参阅 MangroveMarkets MCP服务器.

运作原理

flowchart TD
    Agent[Your Agent] -->|"MCP (Streamable HTTP)"| Server[MangroveMarkets MCP Server]
    Server --> MP[Marketplace tools]
    Server --> DEX[DEX tools]
    Server --> W[Wallet tools]
    Server --> INT[Integration tools]
    Server --> MET[Metrics tools]
    Server --> X402[x402 Payment Layer]
    Server --> XRPL[XRPL Settlement]
    Server --> Storage[Decentralized Storage]

快速开始

使用SDK

pnpm add @mangrove-ai/sdk

import { MangroveClient } from "@mangrove-ai/sdk";

const client = new MangroveClient({
  url: "https://api.mangrovemarkets.com",
  signer,              // implements Signer interface -- keys never leave your machine
  transport: "mcp",    // "mcp" (default) or "rest"
});

await client.connect();

// One-call swap -- handles approval, signing, broadcast, polling
const result = await client.dex.swap({
  src: "0xA0b8...",    // USDC on Base
  dst: "0xEeee...",    // ETH
  amount: "1000000000",
  chainId: 8453,
  slippage: 0.5,
  mode: "standard",    // "standard" (fee in swap) or "x402" (separate payment)
});

// Search the marketplace
const listings = await client.marketplace.search({ query: "GPU compute" });

// Create a wallet
const wallet = await client.wallet.create({ chain: "evm", chainId: 8453 });

直接使用MCP SDK

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "my-agent", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(
  new URL("https://api.mangrovemarkets.com/mcp")
);
await client.connect(transport);

const result = await client.callTool({
  name: "dex_get_quote",
  arguments: { input_token: "USDC", output_token: "ETH", amount: 1000000000, chain_id: 8453 },
});

使用克劳德代码

安装Claude插件，然后直接使用技能：

/swap quote USDC ETH 1000 --chain base
/marketplace search "GPU compute"
/wallet create --chain evm --chainId 8453
/portfolio value --addresses 0xabc

使用OpenClaw

openclaw plugins install @mangrove-ai/openclaw-plugin

文档

从这里开始

文件	目的
产品路线图	高级路线图：4个阶段、工作流、完成标准
SDK设计	SDK架构：传输、签名者接口、API表面
插件设计	Claude插件+OpenClaw插件架构

实施计划

按任务TDD计划，包括精确的文件路径、完整的代码和测试命令。

实施计划	工作流	任务
SDK实施计划	E	19项任务，5个阶段
插件实施计划	F	13个任务

参考

文件	目的
视觉	MangroveMarkets为何存在
品牌指南	视觉识别
贡献.md	开发工作流程、分支、公关流程
代理商.md	代理约定、域边界

路线图

此回购交付 SDK和插件 这会随着服务器的每个阶段而发展。

阶段	链	SDK添加	插件添加
1	基础（EVM）	MCP+REST传输、EthersSigner、DEX交换编排、市场客户端	/swap、/marketer、/钱包、/投资组合技能；OpenClaw工具+仪表板
2	XRPL	XRPL签名者适配器、托管监控	XRPL交换、托管、钱包操作
3	Solana	Solana签名者适配器	Jupiter交换，Solana钱包操作
4	全部	跨链便利方法	指标仪表板、投资组合视图

Phases如何连接到服务器

SDK封装了MCP服务器的工具。服务器端工作流（A-D）必须先交付工具，然后SDK（E）和插件（F）才能封装它们。

flowchart LR
    A1["MCP Server Phase 1 (Foundation)"] --> B1["SDK Phase 1 (Core + DEX)"]
    A1F["MCP Server Phase 1 (FastAPI REST)"] --> B1R["SDK Phase 1 (REST transport)"]
    A2["MCP Server Phase 2 (Ancillary APIs)"] --> B2["SDK Phase 2 (OneInch service)"]
    A3["MCP Server Phase 3 (Portfolio)"] --> B3["SDK Phase 3 (Portfolio + Charts)"]
    A4["MCP Server Phase 4 (x402)"] --> B4["SDK Phase 4 (x402 handler)"]
    B4 --> B5["SDK Phase 5 (Plugins)"]

使用Claude Code

此仓库使用Claude Code的编排器模式和特定于域的代理定义。

对于贡献者

阅读 产品路线图 了解当前阶段
检查哪个 服务器端工具 可用（SDK/插件取决于服务器）
打开 实施计划 对于您的工作流，它有TDD任务和精确的步骤
使用Claude代码执行：每个计划都包含一个标题，指示Claude使用 superpowers:executing-plans

对于Claude代码会话

这 .claude/rules/orchestration.md 定义参谋长模式
中的代理定义 .claude/agents/ 定义领域知识和文件边界
实施计划 docs/plans/ TDD任务列表是为 superpowers:executing-plans
SDK依赖于MCP服务器——在编写SDK包装器之前检查服务器工具的可用性

项目结构

packages/
  sdk/                           # @mangrove-ai/sdk
    src/
      index.ts                   # Main exports
      client/                    # MangroveClient (HTTP wrapper)
      types/                     # TypeScript interfaces
      transport/                 # MCP + REST transport layer
      dex/                       # DEX service, swap orchestration
      oneinch/                   # OneInch ancillary services
      signer/                    # Signer interface + EthersSigner
      x402/                      # x402 payment handler
      marketplace/               # Marketplace client
      wallet/                    # Wallet client
  claude-plugin/                 # @mangrove-ai/claude-plugin
    .claude-plugin/plugin.json   # Plugin manifest
    src/skills/                  # /swap, /marketplace, /wallet, /portfolio
    src/commands/                # /mangrove-status, /mangrove-connect
  openclaw-plugin/               # @mangrove-ai/openclaw-plugin
    openclaw.plugin.json         # Plugin manifest
    src/tools/                   # Tool definitions (delegate to SDK)
    src/handlers/                # Agent hooks
    src/components/              # Dashboard React components
  website/                       # Next.js marketing site
docs/                            # Vision, designs, plans
.claude/                         # Agent definitions, rules, skills

发展

# Clone and install
git clone https://github.com/MangroveTechnologies/MangroveMarkets.git
cd MangroveMarkets
pnpm install

# Build all packages
pnpm build

# Run tests
pnpm test

# Run SDK tests only
pnpm --filter @mangrove-ai/sdk test

# Start the website locally
pnpm --filter website dev

关键原则

代理人是用户，而不是人类。 每一个API决策都针对代理人体工程学进行优化。
开放市场。 没有账户，没有KYC，没有把关。
红树林促进，它不中间。 访问工具，而不是中间商服务。
从简单开始。 在构建复杂系统之前，先运送工作工具。
金钱是一种手段，而不是目的。 代理商使用红树林来获得他们需要的东西。

x402付款

MangroveMarkets使用 x402协议代理付款。SDK自动处理402握手——您的代理调用工具，支付过程透明。

令牌	网络	主持人
USDC	基础	Coinbase（x402.org）
RLUSD	XRPL	t54.ai
USDC	Solana	Coinbase（x402.org）

代理商选择 mode: "standard" （费用计入掉期）或 mode: "x402" （单独支付，更好的掉期产出）。

许可证

麻省理工学院

链接

网站： mangrovemarkes.com
github： @芒果技术
x402协议： x402.org
MCP协议：模型上下文协议.io