使用说明
Cronos402示例
演示Cronos402使用模式的集成示例和模板。
概述
此目录包含自包含的示例,显示了如何将Cronos402支付功能集成到各种应用程序中。每个示例都是一个完整的工作项目,演示了特定的用例和集成模式。
可用示例
cronos天气服务器
生产就绪的MCP天气API和付款要求。
- 类型:付费MCP服务器
- 特性:USDC.e+CRO支付,OpenWeather API集成
- 科技:Express.js、cronos402 SDK
- 自述文件: cronos天气服务器/README.md
身份验证示例
身份验证集成示例。
- 类型:身份验证集成
- 特性:更好的Auth、会话管理、API密钥处理
- 科技:Next.js,更好的身份验证
chatgpt应用sdk-nextjs入门
ChatGPT应用程序与Cronos402集成。
- 类型:ChatGPT插件
- 特性:ChatGPT操作,OpenAPI集成
- 科技:Next.js、OpenAPI
运行示例
每个示例都是自己的pnpm工作空间包:
# Navigate to example
cd examples/cronos-weather-server
# Install dependencies
pnpm install
# Run in development
pnpm dev
# Build for production
pnpm build
示例结构
新示例的最小结构:
example-name/
├── src/ # Source code
├── README.md # Example documentation
├── package.json # Dependencies
├── .env.example # Environment variables template
└── tsconfig.json # TypeScript configuration
创建新示例
指南
- 让例子集中在一个概念上
- 包含全面的自述文件
- 提供
.env.example用于配置 - 在代码中添加清晰的注释
- 包括错误处理
- 在测试网和主网上进行测试
模板结构
// Example: Minimal paid MCP server
import { createMcpHandler } from 'cronos402';
import { z } from 'zod';
const handler = createMcpHandler(
async (server) => {
server.paidTool(
'example_tool',
'Tool description',
'0.01', // Price in USD
{
param: z.string().describe('Parameter description')
},
{},
async ({ param }) => {
// Tool implementation
return {
content: [{
type: 'text',
text: `Result: ${param}`
}]
};
}
);
},
{
recipient: {
'cronos-testnet': '0x...',
'cronos-mainnet': '0x...'
},
facilitator: {
url: 'https://facilitator.cronos402.dev'
}
}
);
export default handler;
示例类别
MCP服务器
构建付费MCP服务器的示例:
- 天气API(cronos-Weather-server)
- API数据示例
- AI服务示例
客户端集成
消费付费服务的示例:
- CLI客户端示例
- ChatGPT应用程序集成
- 自定义MCP客户端实现
认证
身份验证集成示例:
- 更好的身份验证设置
- API密钥管理
- 会话处理
付款流
展示支付模式的示例:
- USDC.e无气支付
- 本地CRO付款
- 付款验证
测试示例
本地测试
# Start example server
pnpm dev
# Test with CLI
npx cronos402 connect --urls http://localhost:3000/mcp --api-key test
测试网测试
# Configure testnet
export CRONOS_NETWORK=cronos-testnet
export RECIPIENT_ADDRESS=0xYourTestnetAddress
# Get test tokens
# TCRO: https://cronos.org/faucet
# devUSDC.e: https://faucet.cronos.org
# Run example
pnpm start
部署示例
维塞尔
cd examples/your-example
vercel
铁路
railway up
Cloudflare员工
wrangler deploy
资源
- SDK文档: docs.cronos402.dev/sdk
- npm包: npmjs.com/package/cronos402
- API 参考: docs.cronos402.dev/api
- GitHub: github/Cronos402/示例
贡献
要添加新示例,请执行以下操作:
- 在中创建目录
examples/ - 添加到pnpm工作区
- 包含全面的自述文件
- 彻底测试
- 提交拉取请求
支持
关于示例的问题:
- 查看示例README文件
- 访问 docs.cronos402.dev
- 在GitHub上打开一个问题
许可证
麻省理工学院