Skip to main content
Glama

KnowMint

License: MIT Deploy: Cloudflare Workers

第一个 AI 智能体可以直接使用 SOL 进行自主支付的知识市场。

人类在此发布隐性知识、经验见解和经过实战检验的解决方案。AI 智能体(如 Claude Code、ElizaOS、AgentKit)通过 x402 协议自主发现、评估并购买这些内容——通过非托管的 Solana P2P 转账直接向卖家支付。平台不持有任何私钥。

同时提供“人在回路”(Human-in-the-loop)模式:智能体进行搜索并提出建议,由你进行确认。同样的市场,你可以选择不同的自主级别。

三种访问层级:Web UI / CLI (km) / REST API + MCP 服务器

Web UI

WebUI Purchase Flow

CLI / MCP (面向 AI 智能体)

AI Agent Autonomous Purchase Demo


为什么选择 KnowMint

  • 首个面向智能体支付的市场 — AI 智能体通过 x402 协议自主使用 SOL 支付。无需人工干预即可完成购买

  • x402 自主购买 — HTTP 402 + Solana P2P 直接转账。智能体端到端地完成发现、支付和获取知识的过程

  • 支持“人在回路”模式 — 智能体提出建议,你来确认。同样的市场,你可以选择不同的自主级别

  • 人类 → AI 知识供给 — 出售 AI 无法自行生成的经验性和隐性知识

  • 非托管支付 — Solana 上的买家对卖家 P2P 直接转账(平台不托管资金)


Related MCP server: mpp32-mcp-server

面向 AI 智能体

获取 API Key

对于 AI 智能体(基于钱包,无需 Web UI):

  1. POST /api/v1/auth/challenge,请求体为 { "wallet": "<base58>", "purpose": "register" }

  2. 使用你的 Solana 钱包对返回的 message 进行签名

  3. POST /api/v1/auth/register,请求体为 { "wallet", "signature", "nonce" }

  4. 接收 { "api_key": "km_...", "user_id", "wallet" } — 即可使用

对于人类用户(Web UI):

  1. 在 knowmint.shop(或你自托管的实例)注册

  2. 进入 Profile → API Keys

  3. 创建一个具有 read 或 write 权限的密钥

  4. 复制密钥 — 它仅显示一次

MCP 服务器

添加到 ~/.claude/mcp.json:

{
  "mcpServers": {
    "knowmint": {
      "command": "npx",
      "args": ["--yes", "--package", "@knowmint/mcp-server@0.1.2", "mcp-server"],
      "env": {
        "KM_BASE_URL": "https://knowmint.shop"
      }
    }
  }
}

初始设置无需 API Key。 智能体可以使用 km_register 自行注册。

自行注册(无需预先拥有账户)

  1. 准备一个 Solana 密钥对文件(例如 ~/.config/solana/id.json)

  2. 使用密钥对路径调用 km_register — 该工具会自动处理挑战、签名和注册过程

  3. API Key 会被保存到 ~/.km/config.json 并用于后续所有调用

km_register(keypair_path: "~/.config/solana/id.json")
  → POST /api/v1/auth/challenge (get nonce)
  → Sign message with keypair
  → POST /api/v1/auth/register (get API key)
  → Saved to ~/.km/config.json — ready to use

重新登录现有账户:km_wallet_login(keypair_path: "...")。

工具参考

工具

描述

km_register

使用 Solana 密钥对注册新账户并获取 API Key

km_wallet_login

重新登录现有账户并获取新的 API Key

km_search

搜索知识

km_get_detail

获取知识详情

km_purchase

购买知识(Solana 转账)

km_get_content

获取已购买的内容(x402 门控)

km_get_version_history

获取版本历史

km_publish

发布知识

x402 自主购买流程

km_get_content()
  → HTTP 402 (payment_required)
  → Solana transfer
  → Retry with payment_proof
  → Content returned

安全性:请勿将配置文件放置在公共仓库或同步目录中。定期轮换密钥。

  • 仅搜索和阅读 (km_search / km_get_detail / km_get_content) → 使用 read 权限密钥

  • 购买和发布 (km_purchase / km_publish) → 使用 write 权限密钥

CLI (km)

独立的 Node.js CLI。配置存储在 ~/.km/config.json 中。

自行注册

# Register with an existing Solana keypair (creates account + saves API key)
km register --keypair ~/.config/solana/id.json

# Register with auto-generated keypair (new wallet created automatically)
km register

# Re-login to an existing account
km wallet-login --keypair ~/.config/solana/id.json

使用方法

km login --base-url https://knowmint.shop   # Manual API key input (if already have one)
km search "prompt engineering"
km install <knowledge_id> --tx-hash <solana_tx_hash> --deploy-to claude
km publish prompt ./prompt.md --price 0.5SOL --tags "seo,marketing"
km my purchases

--deploy-to claude,opencode 可将购买的知识自动部署到你的工具中。

查看 cli/README.md 获取完整文档。


面向人类用户

Web UI 采用复古 RPG 风格设计(灵感来自《勇者斗恶龙》)。人类用户可以:

  • 发布 带有 SOL 定价、预览和标签的知识

  • 浏览 包含提示词、工具定义、数据集和 API 的市场

  • 购买 使用 Phantom 或 Solflare 钱包

  • 追踪 个人仪表板上的销售、购买和反馈记录


快速开始

先决条件:Node.js 22.6+ / npm

git clone https://github.com/Sou0327/knowmint.git
cd knowmint
npm install

# Start local Supabase (applies migrations automatically)
npx supabase start

# Copy and fill environment variables
cp .env.local.example .env.local

# Start dev server
npm run dev   # http://localhost:3000

所需环境变量

变量

描述

NEXT_PUBLIC_SUPABASE_URL

Supabase 项目 URL

NEXT_PUBLIC_SUPABASE_ANON_KEY

Supabase 匿名密钥

SUPABASE_SERVICE_ROLE_KEY

管理员客户端(API 路由)

可选(生产环境推荐)

变量

描述

NEXT_PUBLIC_SOLANA_RPC_URL

Solana RPC URL

NEXT_PUBLIC_SOLANA_NETWORK

devnet(默认)/ mainnet-beta

X402_NETWORK

x402 支付网络 CAIP-2 标识符

CRON_SECRET

定时任务认证密钥

UPSTASH_REDIS_REST_URL

速率限制(Upstash Redis)

UPSTASH_REDIS_REST_TOKEN

速率限制令牌

WEBHOOK_SIGNING_KEY

Webhook 签名验证


智能体插件

Coinbase AgentKit (packages/agentkit-plugin/)

面向 AgentKit 智能体的 ActionProvider<WalletProvider> 插件。

cd packages/agentkit-plugin && npm install && npm run build

5 个操作:km_search / km_get_detail / km_purchase / km_get_content / km_publish

ElizaOS (packages/eliza-plugin/)

面向 ElizaOS 框架的插件。

cd packages/eliza-plugin && npm install && npm run build
import { knowmintPlugin } from "@knowmint/eliza-plugin";

const character = {
  plugins: [knowmintPlugin],
  settings: {
    KM_API_KEY: "km_xxx",
    KM_BASE_URL: "https://knowmint.shop", // optional
  },
};

操作:SEARCH_KNOWLEDGE / PURCHASE_KNOWLEDGE / GET_CONTENT 提供者:trending-knowledge(前 5 名注入到上下文中)


API 概览

大多数端点受 withApiAuth 保护(API Key 认证 + 速率限制)。 完整参考:docs/openapi.yaml / docs/api-guidelines.md

认证(无需 API Key)

方法

路径

描述

POST

/api/v1/auth/challenge

获取签名挑战(钱包 + 用途)

POST

/api/v1/auth/register

使用钱包签名注册 → 接收 API Key

POST

/api/v1/auth/login

使用钱包签名重新登录 → 接收新 API Key

知识

方法

路径

描述

GET

/api/v1/knowledge

列出知识

POST

/api/v1/knowledge

创建知识

POST

/api/v1/knowledge/batch

批量获取

GET

/api/v1/knowledge/{id}

获取详情

PATCH

/api/v1/knowledge/{id}

更新

POST

/api/v1/knowledge/{id}/publish

发布

POST

/api/v1/knowledge/{id}/purchase

购买(Solana 交易验证)

GET

/api/v1/knowledge/{id}/content

获取内容(x402 门控)

POST

/api/v1/knowledge/{id}/feedback

提交反馈

用户

方法

路径

描述

GET

/api/v1/me/purchases

购买历史

GET

/api/v1/me/listings

我的发布

POST

/api/v1/me/wallet/challenge

SIWS 挑战

POST

/api/v1/me/wallet/verify

钱包验证


技术栈

层级

技术

前端

Next.js 16 (App Router) + React 19, TypeScript, Tailwind CSS v4

后端 / 数据库

Supabase (PostgreSQL, Auth, Storage, RLS)

支付

Solana (非托管 P2P, Anchor 0.32)

速率限制

Upstash Redis

MCP

@knowmint/mcp-server (@modelcontextprotocol/sdk)

部署

Cloudflare Workers (opennextjs-cloudflare)

测试

Mocha/Chai (单元/集成), Vitest (组件)


测试

# Unit tests (202 tests, Mocha/Chai)
npm run test:unit

# Component tests (Vitest)
npm run test:components

# Staging integration tests (requires supabase start)
npm run test:staging

# E2E tests
npm run test:e2e:fake-tx        # Fake transaction rejection
npm run test:e2e:cli-flow       # CLI flow (login/search/install/publish/deploy)
npm run test:e2e:cli-purchase   # CLI purchase flow
npm run test:e2e:x402-flow      # HTTP 402 payment gate
npm run test:e2e:devnet         # Devnet SOL transfer → purchase → content

有关使用完整购买流程进行本地 devnet 测试的信息,请参阅 本地 Devnet 测试指南。


部署

通过 opennextjs-cloudflare 部署到 Cloudflare Workers。

npm run build:cf    # Build + strip @vercel/og WASM
npm run deploy:cf   # Deploy to production

CI/CD (.github/workflows/deploy.yml):

  • 推送到 main → 自动部署到生产环境 Worker

  • 创建 PR → 自动部署到预览 Worker

  • 关闭 PR → 删除预览 Worker


贡献

  1. Fork 本仓库

  2. 创建功能分支 (git checkout -b feature/my-feature)

  3. 提交你的更改

  4. 推送到分支并开启 Pull Request


许可证

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that allows AI agents to discover and pay for thousands of APIs (x402 on Solana/Base) using a single key, with automatic payment handling and a federated catalog of machine-payable endpoints.
      221
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that gives AI agents a Solana wallet to autonomously launch and trade tokens on Solana's AgentPump bonding-curve launchpad via natural language.
      63 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server for agentic commerce, enabling AI agents to discover services, make x402 payments with USDC across multiple chains, and manage crypto wallets and token swaps.
      339 npm
      1
      MIT