项目简介

Starknet MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为 AI 智能体提供与 Starknet 区块链交互的能力。它通过标准化的 MCP 接口，使得 AI 智能体可以使用自然语言来查询 Starknet 区块链数据、管理钱包、并与智能合约进行交互。该服务器支持 Mainnet 和 Sepolia 测试网络，并集成了 StarknetID，方便用户使用人类可读的身份进行操作。

主要功能点

区块链数据查询: 支持查询链信息、区块信息、交易信息、地址信息和合约数据。
原生代币操作: 支持 ETH 和 STRK 的余额查询和转账。
ERC20 代币操作: 支持 ERC20 代币的余额查询、转账和信息查询。
NFT 操作: 支持 NFT 的所有权查询和余额查询。
智能合约交互: 支持调用智能合约的只读函数和执行写入操作。
StarknetID 集成: 支持 StarknetID 的解析和反向解析，以及 StarknetID 个人资料查询。
双传输协议: 支持 Stdio 和 HTTP 两种传输协议，满足不同应用场景的需求。
AI 友好: 设计用于与 Claude、GPT 等 AI 助手配合使用。

安装步骤

本仓库提供了多种安装方式，以下是推荐的快速开始方式：

方式一：使用 npx 运行 (无需安装)

这是最简单的开始方式，无需全局安装即可运行服务器。

确保你的电脑上已安装 Node.js (>= 18.0.0) 或 Bun (>= 1.0.0)。

打开终端，根据需要运行以下命令：

运行 Stdio 服务器（用于 CLI 工具和 AI 助手）：

npx @mcpdotdirect/starknet-mcp-server

运行 HTTP 服务器（用于 Web 应用）：

npx @mcpdotdirect/starknet-mcp-server http

方式二：全局安装

如果需要频繁使用，可以全局安装以便直接在终端中运行命令。

确保你的电脑上已安装 Node.js (>= 18.0.0) 或 Bun (>= 1.0.0)。

打开终端，运行以下命令进行全局安装：

npm install -g @mcpdotdirect/starknet-mcp-server

安装完成后，即可在任何目录下使用以下命令运行服务器：

运行 Stdio 服务器：
```
starknet-mcp-server
```

运行 HTTP 服务器：

starknet-mcp-server http

服务器配置

Starknet MCP Server 默认使用 Mainnet 网络，HTTP 服务器默认监听 3000 端口。

MCP 客户端配置 (以 Cursor 为例)

MCP 客户端（如 Cursor）需要配置 MCP 服务器的启动命令才能连接。配置信息通常以 JSON 格式提供。

1. Stdio 模式配置 (command 类型)

用于连接 Stdio 版本的 Starknet MCP Server。

{
  "mcpServers": {
    "starknet-mcp-stdio": {
      "command": "npx",
      "args": [
        "@mcpdotdirect/starknet-mcp-server"
      ]
    }
  }
}

'server name': 服务器名称，可以自定义，例如 'starknet-mcp-stdio'。
'type': 服务器类型，这里是 'command'，表示通过命令行启动。
'command': 启动服务器的命令，这里使用 'npx'。
'args': 命令参数，这里指定了要运行的 npm 包 '@mcpdotdirect/starknet-mcp-server'。

2. HTTP 模式配置 (url 类型)

用于连接 HTTP 版本的 Starknet MCP Server。

{
  "mcpServers": {
    "starknet-mcp-http": {
      "url": "http://localhost:3000/sse"
    }
  }
}

'server name': 服务器名称，可以自定义，例如 'starknet-mcp-http'。
'type': 服务器类型，这里是 'url'，表示通过 URL 连接。
'url': HTTP 服务器的 SSE 端点 URL，默认为 'http://localhost:3000/sse'。请确保 HTTP 服务器已启动并监听在 3000 端口。

配置文件的位置

Cursor: 可以在 Cursor 的设置中手动添加 MCP Server，或者在项目根目录的 '.cursor/mcp.json' 文件中配置。

基本使用方法

启动服务器: 根据安装步骤选择 Stdio 或 HTTP 模式启动 Starknet MCP Server。
配置 MCP 客户端: 在 MCP 客户端（如 Cursor）中，根据服务器的运行模式选择相应的配置信息（stdio 或 http）。
在 MCP 客户端中使用: 连接成功后，即可在 MCP 客户端中使用自然语言指令或代码调用 MCP Server 提供的工具和资源，与 Starknet 区块链进行交互。

示例 (Cursor)

在 Cursor 中，配置并连接 Starknet MCP Server 后，即可在代码编辑器中通过自然语言提问，例如：

"Check the ETH balance of vitalik.stark"
"Get information about the latest block on Starknet"
"Look up the owner of NFT #123 in collection 0x..."

Cursor 将会自动调用 Starknet MCP Server 提供的工具来执行这些操作，并将结果返回给你。

示例 (Claude CLI)

使用 Claude CLI 连接 MCP Server：

# 添加 MCP 服务器
claude mcp add starknet-mcp-server npx @mcpdotdirect/starknet-mcp-server

# 启动 Claude 并启用 MCP 服务器
claude

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息