1ly MCP Server
使用说明（Markdown 格式）
-
项目简介
- 该仓库实现了一个 MCP 服务器，基于 Model Context Protocol，通过 JSON-RPC 与 MCP 客户端通信，向 AI 代理提供资源管理、工具注册与执行、以及提示/上下文渲染等能力。同时集成了区块链支付能力（Solana/Base 钱包、x402 协议），支持按调用预设预算进行支付与结算，提供自定义的预算与会话管理逻辑。
-
主要功能点
- MCP 核心能力：实现服务器端对工具、资源、提示等的注册、查询与执行，遵循 MCP 的请求/响应结构。
- 工具系统：提供与 1ly store 相关的买卖类工具（如搜索、详情、下单调用、购买后评审、创建/更新/删除链接等），通过统一的工具注册与调用接口暴露给 MCP 客户端。
- 资源与商店管理：实现店铺创建、链接管理、钥匙/key 管理、统计等商店运营相关能力。
- 支付与账务：支持基于 x402 的支付握手、Solana 与 EVM（Base）钱包集成、每日预算与单次调用预算控制，以及按需的提现/钥匙管理等财务流程。
- 会话与错误处理：通过统一的响应结构（成功/错误）与日志机制，处理 MCP 请求、错误情况及自检测试。
- 传输与部署：基于标准 MCP 服务实现，配合 STDIO 传输等方式对接客户端。
-
安装步骤
- 克隆仓库并进入项目目录
- 安装依赖：npm install
- 运行服务：npx @1ly/mcp-server
- 自测（可选）：npx @1ly/mcp-server --self-test
-
服务器配置（MCP 客户端需要的配置信息）
- MCP 客户端要连接该服务器，需提供以下 JSON 配置，其中包含服务器名称、启动命令及参数等信息（仅用于客户端了解如何启动与连接，不要求在 MCP 客户端执行代码）： { "server": "1ly", "command": "npx", "args": ["@1ly/mcp-server"], "notes": "运行前需设置钱包相关环境变量，如 ONELY_WALLET_SOLANA_KEY、ONELY_WALLET_EVM_KEY；可选设置 ONELY_API_KEY、预算控制变量等（客户端不需要实际使用这些变量，只为服务器运行时提供环境信息）。" }
说明
- 以上配置仅用于文档说明 MCP 客户端如何启动与连接 MCP 服务器；实际的连接与通讯由 MCP 客户端在运行时根据服务端暴露的能力与协议进行。
- 服务器支持的环境变量示例（用于服务器启动时的支付与配置）包括：ONELY_WALLET_SOLANA_KEY、ONELY_WALLET_EVM_KEY、ONELY_API_BASE、ONELY_API_KEY、ONELY_BUDGET_PER_CALL、ONELY_BUDGET_DAILY、ONELY_BUDGET_STATE_FILE、ONELY_NETWORK。
- MCP 客户端在使用时无需关心服务器内部的实现细节，只需通过标准的 ListTools 与 CallTool 流程即可与服务器交互。
-
基本使用方法
- 启动服务器
- 设置钱包与预算相关环境变量后，执行启动命令：npx @1ly/mcp-server
- 浏览工具（ListTools）
- MCP 客户端请求“列出可用工具”，服务器返回可调用的工具集合（如 1ly_search、1ly_get_details、1ly_call、1ly_review 等）。
- 调用工具
- 客户端选择一个工具并传入参数，例如 1ly_search、1ly_get_details、1ly_call 等，服务器按工具实现执行并返回结构化的 MCP 响应。若涉及支付，服务器将处理 402/支付流程、预算校验与签名等。
- 管理商店与资源
- 通过 1ly_create_store、1ly_create_link、1ly_list_links、1ly_update_link、1ly_delete_link 等工具，对商店、链接进行创建、查询、更新与删除。
- 自检与自测
- 使用 --self-test 选项对环境与网络进行自检，确保钱包配置、网络连通性与 API 可达性。
备注
- MCP 客户端通常通过 JSON-RPC 与服务器对话，服务器返回的内容统一采用 MCP 的 content 段格式与 ok/error 结构。
- 启动服务器