【技术文档摘要】

<div align="center"> <img src="./cairo-grey.png" alt="Cairo Coder MCP Logo" width="300"/>

</div>

Cairo Coder MCP 服务器

一个用于 Cairo 和 Starknet 开发辅助的 Model Context Protocol (MCP) 服务器，通过 Cairo Coder API 提供支持。

⚠️ 仓库已迁移 / 已弃用

此项目现在位于 Ask Starknet 单一代码库

npm 包仍然发布在 这里

此仓库将不再接收更新。

快速开始

通过 Claude Code 安装

# 安装 Cairo Coder MCP
claude mcp add cairo-coder -e CAIRO_CODER_API_KEY=YOUR-API-KEY-HERE -- npx -y @kasarlabs/cairo-coder-mcp

注意: 将 YOUR-API-KEY-HERE 替换为从 cairo-coder.com 获取的实际 API 密钥。

手动使用

直接使用 npx 来运行此 MCP 服务器：

npx -y @kasarlabs/cairo-coder-mcp

配置

该服务器支持两种操作模式：

模式 1: 公共 Cairo Coder API（默认）

使用官方 Cairo Coder API 及您的 API 密钥。

环境变量：

• CAIRO_CODER_API_KEY: 您的 Cairo Coder API 密钥（必需）

MCP 客户端设置：

{
  "mcpServers": {
    "cairo-coder": {
      "command": "npx",
      "args": ["-y", "@kasarlabs/cairo-coder-mcp"],
      "env": {
        "CAIRO_CODER_API_KEY": "your-api-key-here"
      }
    }
  }
}

模式 2: 本地/自定义端点

使用本地或自定义的 Cairo Coder API 端点（无需 API 密钥）。

环境变量：

• CAIRO_CODER_API_ENDPOINT: 您的本地端点 URL（例如："http://localhost:8000"）

MCP 客户端设置：

{
  "mcpServers": {
    "cairo-coder": {
      "command": "npx",
      "args": ["-y", "@kasarlabs/cairo-coder-mcp"],
      "env": {
        "CAIRO_CODER_API_ENDPOINT": "http://localhost:8000"
      }
    }
  }
}

注意: 当使用 CAIRO_CODER_API_ENDPOINT 时，服务器会自动切换到本地模式，并且不需要也不使用 API 密钥。

可用工具

assist_with_cairo

获得 Cairo 和 Starknet 开发任务的帮助。

参数：

• query (字符串，必需): 您的 Cairo/Starknet 开发问题
• context (字符串，可选): 额外的上下文或代码片段

示例：

// 简单请求
{
  "query": "编写一个实现计数器的简单 Cairo 合约"
}

// 带有上下文
{
  "query": "如何优化这个合约？",
  "context": "#[starknet::contract]\nmod Counter {\n    // 现有的代码在这里\n}"
}

您可以做什么

• 编写 Cairo 代码: 生成智能合约和 Cairo 代码
• 重构代码: 改进和优化现有代码
• 实现功能: 完成 TODO 并实现特定功能
• 学习 Starknet: 获得关于 Starknet 生态系统的上下文信息
• 最佳实践: 根据 Cairo/Starknet 文档获得建议

更好结果的小贴士

• 使用具体的查询（例如，“使用 OpenZeppelin 构建 ERC20”而不是仅仅“ERC20”）
• 在处理现有代码时包含相关的代码片段
• 提供必要的上下文以获得更准确的回答

开发

先决条件

• Node.js >= 18
• npm 或 yarn

本地安装

git clone <repository-url>
cd cairo-coder-mcp
npm install

可用脚本

npm run build    # 构建项目
npm run dev      # 开发模式启动
npm start        # 生产模式启动

许可证

MIT

支持

对于问题和疑问：

• GitHub Issues: 创建问题
• MCP 文档: Model Context Protocol

贡献

欢迎贡献！请在提交 PR 之前检查贡献指南。