返回 MCP 目录
public公开dns本地运行

kaiafun-mcp

一个用于KaiaFun协议和Kaia区块链交互的MCP服务器

article

README

🚀 🐍 ☁️ KaiaFun MCP 服务器

KaiaFun MCP 服务器基于开放的模型上下文协议(MCP),标准化了应用向大型语言模型提供上下文的方式。此服务器支持代币列表、交易以及与 Kaia 区块链交互,为相关应用提供了有力支持。

🚀 快速开始

安装

# 克隆仓库
git clone https://github.com/weerofun/kaiafun-mcp
cd kaiafun-mcp

# 安装依赖项
yarn

# 构建
yarn build

构建过程将在 tsconfig.json 中指定的目录(默认为 dist)生成输出,通过 tsc。要启动 MCP 服务器,请运行 dist/kaiafun-mcp-server.js (见下文的#配置)。

配置

更新你的Claude Desktop配置文件,修改 claude_desktop_config.json

{
  "mcpServers": {
    "kaiafun": {
      "command": "node",
      "args": ["/path/to/dist/kaiafun-mcp-server.js"],
      "env": {
        "PRIVATE_KEY": "0x"
      }
    },
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}
  • mcpServers.kaiafun.args[0] 设置为 dist/kaiafun-mcp-server.js 的绝对路径。
  • 使用配置的账户私钥设置 PRIVATE_KEY
  • 我们还建议添加@modelcontextprotocol/server-puppeteer到你的配置中以获得基本的网络浏览功能。

⚠️ 重要提示

请注意,将私钥(PRIVATE_KEY)明文存储是不安全的,这主要用于开发/探索目的。此仓库目前处于开发阶段,相关项目、协议和实体的贡献者不对因使用此项目导致的资金损失或其他问题负责。每个人都可以自行承担风险地使用此项目,并通过打开问题和拉取请求来为项目做出贡献。💗

✨ 主要特性

  • 实现了针对 KaiaFun 协议的 MCP 服务器,支持代币列表、交易以及与 Kaia 区块链交互。
  • 开发中的 TypeScript SDK 为 MCP 服务器提供核心功能,支持列出新代币及其预定义元数据、使用 KAIA 购买和出售代币。

📦 安装指南

安装步骤

# 克隆仓库
git clone https://github.com/weerofun/kaiafun-mcp
cd kaiafun-mcp

# 安装依赖项
yarn

# 构建
yarn build

📚 详细文档

配置说明

更新Claude Desktop的配置文件 claude_desktop_config.json,具体配置如下:

{
  "mcpServers": {
    "kaiafun": {
      "command": "node",
      "args": ["/path/to/dist/kaiafun-mcp-server.js"],
      "env": {
        "PRIVATE_KEY": "0x"
      }
    },
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

配置要点:

  • 需将 mcpServers.kaiafun.args[0] 设置为 dist/kaiafun-mcp-server.js 的绝对路径。
  • 用配置的账户私钥设置 PRIVATE_KEY
  • 建议添加@modelcontextprotocol/server-puppeteer以获得基本网络浏览功能。

SDK 功能

我们正在开发的 TypeScript SDK 位于 src/sdk 目录,目前支持以下功能:

  • ✅ 列出新的代币及其预定义元数据
  • ✅ 使用 KAIA 购买和出售代币

需注意,SDK 处于测试版本,功能和实现可能会发生变化。

📄 许可证

本项目根据Apache License 2.0授权。版权所有 2025 KaiaFun。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端