使用说明

项目简介

SpoonOS核心开发者框架 (SCDF) 是一个强大的AI Agent框架，旨在构建智能、可组合的代理。其核心部分通过 Model Context Protocol (MCP) 暴露了一系列专门为Web3和加密货币领域设计的工具，使AI Agent能够访问链上数据、执行交易、进行市场分析等。本项目仓库包含了MCP服务器端的实现代码，负责托管这些工具并响应来自MCP客户端（例如SCDF构建的AI Agent）的请求。

主要功能点

丰富的工具集： 提供访问加密货币市场数据、区块链分析、钱包信息、DeFi协议交互等多种工具。
MCP协议支持： 实现标准的MCP协议，通过JSON-RPC接收客户端请求，调用内部工具并返回结果。
数据访问能力： 工具可以访问中心化交易所(CEX)、去中心化交易所(DEX)数据、区块链链上数据等。
功能调用能力： 工具支持执行如代币转账等操作（需要相应密钥配置）。
灵活的集成： 作为独立的MCP服务器运行，可被任何符合MCP协议的客户端连接和使用。

安装步骤

确保已安装 Python 3.10+ 和 pip (或 uv)。

克隆仓库：

git clone https://github.com/XSpoonAi/spoon-core.git
cd spoon-core

安装依赖：

pip install -r requirements.txt
# 或使用 uv: uv pip install -r requirements.txt

（可选）安装开发模式依赖：

pip install -e .
# 或使用 uv: uv pip install -e .

服务器配置

MCP客户端需要配置MCP服务器的启动信息才能连接。对于本项目提供的MCP工具集合服务器，其启动命令如下。请注意，MCP客户端通常不需要看到或执行此命令本身，只需知道如何连接到已运行的服务器即可。典型的连接方式是指定服务器地址和传输协议。

{
  "server name": "SpoonAI MCP Tools",
  "command": "python",
  "args": ["spoon_ai/tools/mcp_tools_collcetion.py"],
  "connection_url": "sse://127.0.0.1:8765",
  "description": "SpoonAI提供的MCP工具服务，包含加密货币、区块链等领域工具。"
}

'server name': MCP服务器的标识名称。
'command': 启动MCP服务器的可执行命令（通常是'python'）。
'args': 传递给command的参数（即要执行的Python脚本路径）。
'connection_url': MCP客户端连接服务器的地址，默认使用SSE协议和指定端口。
'description': 服务器功能的简要描述。

基本使用方法

启动MCP服务器： 打开终端，切换到项目根目录，运行以下命令启动MCP工具集合服务器：
```
python spoon_ai/tools/mcp_tools_collcetion.py
```
服务器将在后台运行并监听连接（默认为 'sse://127.0.0.1:8765'）。
配置MCP客户端： 在你的MCP客户端应用中，使用上一步提供的 'connection_url' ('sse://127.0.0.1:8765') 和其他必要的连接参数来连接到SpoonAI MCP工具服务器。
发现和使用工具： 连接成功后，你的MCP客户端应该能够发现该服务器暴露的所有工具（例如 'get_token_price', 'wallet_analysis', 'token_transfer' 等），并可以通过JSON-RPC调用这些工具。具体的工具名称和参数信息可以通过客户端的MCP发现机制获取。

关键词