MCP-帽子服务器

Name: MCP-帽子服务器
Author: dennisonbertram

作者：dennisonbertram8 星标更新：2025-08-27

安装使用来源：spider==github.com

项目介绍

Hats Protocol MCP Server

一个全面的模型上下文协议（MCP）服务器，用于管理Hats Protocol操作，包括角色管理、权限检查、组织结构以及跨多个区块链网络的分析。

功能

帽子管理：创建、铸造、销毁和转移帽子
树操作：管理分层组织结构
权限检查：验证佩戴者、状态和资格
元数据操作：更新帽子详情和属性
查询工具：使用GraphQL子图搜索和过滤帽子
分析：生成报告并跟踪活动
多链支持：适用于所有Hats Protocol网络
外部签名：准备硬件钱包签名的交易

支持的网络

主网

Ethereum
Polygon
Arbitrum One
Optimism
Base
Gnosis Chain

测试网

Sepolia
Base Sepolia

安装

# 克隆仓库
git clone <repository-url>
cd mcp-hats-protocol-server

# 安装依赖
npm install

# 构建项目
npm run build

配置

环境变量

复制 .env.template 到 .env 并进行配置：

# RPC提供程序API密钥（可选 - 如果未提供，则使用公共端点）
ALCHEMY_API_KEY=your_key_here
INFURA_API_KEY=your_key_here

# 区块浏览器API密钥（合约验证所需）
ETHERSCAN_API_KEY=your_key_here
POLYGONSCAN_API_KEY=your_key_here
# ...其他浏览器密钥

API密钥管理

您也可以使用MCP工具设置API密钥：

{
  "tool": "set-api-key",
  "args": {
    "keyName": "ALCHEMY_API_KEY",
    "value": "your_key_here"
  }
}

使用

与Claude Code集成

最简单的方式是将其与Claude Code集成。安装服务器后，将其添加到您的Claude配置中：

快速设置

# 克隆并安装服务器
git clone https://github.com/your-username/mcp-hats
cd mcp-hats
npm install
npm run build

# 添加到Claude Code（可选API密钥以提高性能）
claude mcp add hats-protocol --env ALCHEMY_API_KEY=your_key_here -- node dist/index.js

替代设置方法

选项1：本地开发（无需构建）

claude mcp add hats-protocol --env ALCHEMY_API_KEY=your_key_here -- npx tsx src/index.ts

选项2：全局NPM安装（如果已发布）

claude mcp add hats-protocol --env ALCHEMY_API_KEY=_your_key_here -- npx mcp-hats-protocol

选项3：团队/项目配置

# 通过.mcp.json共享团队
claude mcp add --scope project hats-protocol --env ALCHEMY_API_KEY=your_key_here -- node dist/index.js

# 跨所有项目访问用户范围
claude mcp add --scope user hats-protocol --env ALCHEMY_API_KEY=your_key_here -- node dist/index.js

管理集成

# 列出所有MCP服务器
claude mcp list

# 查看服务器详情
claude mcp get hats-protocol

# 移除服务器
claude mcp remove hats-protocol

在Claude Code中的环境变量

添加服务器时可以设置API密钥：

claude mcp add hats-protocol \
  --env ALCHEMY_API_KEY=your_alchemy_key \
  --env ETHERSCAN_API_KEY=your_etherscan_key \
  -- node dist/index.js

手动服务器使用

如果您希望手动运行服务器（用于开发或独立使用）：

# 开发模式
npm run dev

# 生产模式
npm start

与Claude Code一起使用

一旦集成，您可以在与Claude的对话中直接使用Hats Protocol工具：

示例：检查某人是否具有某个角色

检查地址0x742C3cF9Af45f91B109a81EfEaf11535ECDe9571在Ethereum上是否佩戴了帽子0x0000000100010000000000000000000000000000000000000000000000000000

示例：创建一个新的组织

帮我创建一个名为“TechCollective”的DAO在Base Sepolia上，我自己（0x742C3cF9Af45f91B109a81EfEaf11535ECDe9571）作为创始人

示例：分析组织结构

显示Base上的树0x00000001的组织结构，并将其可视化为ASCII树

示例：获取角色分配指导

我需要将CTO角色分配给新团队成员。你能引导我完成这个过程并准备交易吗？

Claude将自动使用适当的Hats Protocol工具并通过内置提示和资源提供智能指导。

可用工具

帽子管理

create-hat - 在层级中创建新的帽子
mint-hat - 将帽子分配给佩戴者
burn-hat - 从佩戴者处移除帽子
transfer-hat - 在佩戴者之间转移帽子

权限检查

check-hat-wearer - 验证地址是否佩戴特定帽子
check-hat-standing - 检查佩戴者是否处于良好状态

查询工具

get-hat-details - 获取帽子的详细信息
query-hats-by-wearer - 获取地址佩戴的所有帽子
get-tree-structure - 获取分层树结构

网络工具

list-networks - 列出所有支持的网络
set-api-key - 配置API密钥

示例命令

创建一个帽子

{
  "tool": "create-hat",
  "args": {
    "networkName": "ethereum",
    "admin": "0x0000000100000000000000000000000000000000000000000000000000000000",
    "details": "工程团队负责人",
    "maxSupply": 1,
    "eligibility": "0x0000000000000000000000000000000000000000",
    "toggle": "0x0000000000000000000000000000000000000000",
    "mutable": true,
    "imageURI": "https://example.com/hat-image.png"
  }
}

检查帽子佩戴者

{
  "tool": "check-hat-wearer",
  "args": {
    "networkName": "ethereum",
    "wearer": "0x742C3cF9Af45f91B109a81EfEaf11535ECDe9571",
    "hatId": "0x0000000100010000000000000000000000000000000000000000000000000000"
  }
}

开发

项目结构

src/
├── index.ts           # 入口点
├── server.ts          # MCP服务器设置
├── types/             # TypeScript定义
├── utils/             # 工具函数
├── networks/          # 网络配置
├── clients/           # Hats SDK和子图客户端
├── tools/             # MCP工具实现
└── resources/         # MCP资源

test/
├── unit/              # 单元测试
├── integration/       # 集成测试
└── e2e/              # 端到端测试

运行测试

# 运行所有测试
npm test

# 运行带有覆盖率的测试
npm run test:coverage

# 运行特定测试套件
npm run test:unit
npm run test:integration
npm run test:e2e

代码质量

# 类型检查
npm run typecheck

# 代码检查
npm run lint

# 格式化
npm run format

架构

核心组件

MCP服务器：处理工具注册和请求路由
Hats客户端：围绕Hats Protocol SDK的封装
子图客户端：用于查询索引数据的GraphQL客户端
网络管理器：多链配置和RPC管理
工具实现：针对特定操作的个别工具

数据流

MCP客户端发送工具请求 → MCP服务器
服务器使用Zod模式验证输入
工具实现调用适当的方法
客户端与区块链或子图交互
响应格式化并返回给MCP客户端