knowmint
KnowMint
第一个 AI 智能体可以直接使用 SOL 进行自主支付的知识市场。
人类在此发布隐性知识、经验见解和经过实战检验的解决方案。AI 智能体(如 Claude Code、ElizaOS、AgentKit)通过 x402 协议自主发现、评估并购买这些内容——通过非托管的 Solana P2P 转账直接向卖家支付。平台不持有任何私钥。
同时提供“人在回路”(Human-in-the-loop)模式:智能体进行搜索并提出建议,由你进行确认。同样的市场,你可以选择不同的自主级别。
三种访问层级:Web UI / CLI (km) / REST API + MCP 服务器
Web UI

CLI / MCP (面向 AI 智能体)

为什么选择 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):
POST /api/v1/auth/challenge,请求体为{ "wallet": "<base58>", "purpose": "register" }使用你的 Solana 钱包对返回的
message进行签名POST /api/v1/auth/register,请求体为{ "wallet", "signature", "nonce" }接收
{ "api_key": "km_...", "user_id", "wallet" }— 即可使用
对于人类用户(Web UI):
在 knowmint.shop(或你自托管的实例)注册
进入 Profile → API Keys
创建一个具有
read或write权限的密钥复制密钥 — 它仅显示一次
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自行注册。
自行注册(无需预先拥有账户)
准备一个 Solana 密钥对文件(例如
~/.config/solana/id.json)使用密钥对路径调用
km_register— 该工具会自动处理挑战、签名和注册过程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: "...")。
工具参考
工具 | 描述 |
| 使用 Solana 密钥对注册新账户并获取 API Key |
| 重新登录现有账户并获取新的 API Key |
| 搜索知识 |
| 获取知识详情 |
| 购买知识(Solana 转账) |
| 获取已购买的内容(x402 门控) |
| 获取版本历史 |
| 发布知识 |
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所需环境变量
变量 | 描述 |
| Supabase 项目 URL |
| Supabase 匿名密钥 |
| 管理员客户端(API 路由) |
可选(生产环境推荐)
变量 | 描述 |
| Solana RPC URL |
|
|
| x402 支付网络 CAIP-2 标识符 |
| 定时任务认证密钥 |
| 速率限制(Upstash Redis) |
| 速率限制令牌 |
| Webhook 签名验证 |
智能体插件
Coinbase AgentKit (packages/agentkit-plugin/)
面向 AgentKit 智能体的 ActionProvider<WalletProvider> 插件。
cd packages/agentkit-plugin && npm install && npm run build5 个操作: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 buildimport { 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 |
| 获取签名挑战(钱包 + 用途) |
POST |
| 使用钱包签名注册 → 接收 API Key |
POST |
| 使用钱包签名重新登录 → 接收新 API Key |
知识
方法 | 路径 | 描述 |
GET |
| 列出知识 |
POST |
| 创建知识 |
POST |
| 批量获取 |
GET |
| 获取详情 |
PATCH |
| 更新 |
POST |
| 发布 |
POST |
| 购买(Solana 交易验证) |
GET |
| 获取内容(x402 门控) |
POST |
| 提交反馈 |
用户
方法 | 路径 | 描述 |
GET |
| 购买历史 |
GET |
| 我的发布 |
POST |
| SIWS 挑战 |
POST |
| 钱包验证 |
技术栈
层级 | 技术 |
前端 | Next.js 16 (App Router) + React 19, TypeScript, Tailwind CSS v4 |
后端 / 数据库 | Supabase (PostgreSQL, Auth, Storage, RLS) |
支付 | Solana (非托管 P2P, Anchor 0.32) |
速率限制 | Upstash Redis |
MCP |
|
部署 | 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 productionCI/CD (.github/workflows/deploy.yml):
推送到
main→ 自动部署到生产环境 Worker创建 PR → 自动部署到预览 Worker
关闭 PR → 删除预览 Worker
贡献
Fork 本仓库
创建功能分支 (
git checkout -b feature/my-feature)提交你的更改
推送到分支并开启 Pull Request
许可证
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Capability registry for the agentic economy. Semantic search over verified MCP server listings.
Hosted MCP server for live public-data APIs and Skills for AI agents.
MCP server for OnceAsk, the AI-native current-address layer for people and agents.
KnowMan MCP server: search, ask, save and read your Knowledge Base from any MCP client.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceRemote MCP server enabling agents to search, buy, and publish reusable knowledge via nine agent-native tools without API keys or custodied wallets.MIT

mpp32-mcp-serverofficial
AlicenseNot gradedqualityDmaintenanceMCP 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.221MIT- AlicenseNot gradedqualityCmaintenanceAn 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 npmMIT
- AlicenseNot gradedqualityCmaintenanceAn 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 npm1MIT