Mangrove Markets

曼格罗夫市场

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

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

这是什么？

此repo包含 客户端包 MangroveMarkets：

对于 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

文档

从这里开始

实施计划

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

参考

路线图

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

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的编排器模式和特定于域的代理定义。

对于贡献者

1. 阅读 产品路线图 了解当前阶段
2. 检查哪个 服务器端工具 可用（SDK/插件取决于服务器）
3. 打开 实施计划 对于您的工作流，它有TDD任务和精确的步骤
4. 使用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

关键原则

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

x402付款

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

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

许可证

麻省理工学院

链接

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