智能合约开发助手

一个为Agoric智能合约开发提供AI辅助工具的MCP服务器,支持开发、测试、调试和部署智能合约。

  • by Agoric
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Agoric/agoric-dev-mcp

使用说明

Agoric开发MCP服务器

MCP(模型上下文协议)服务器,为AI助手提供Agoric智能合约开发工具。该服务器使Claude和其他兼容MCP的AI助手能够帮助开发人员在Agoric区块链上构建、测试、调试和部署智能合约。

特性

该服务器提供10个类别的工具:

  • 项目设置 -初始化和配置Agoric项目
  • 核心模式 -激动人心的开发模式和最佳实践
  • 合同结构 -智能合约脚手架和结构
  • Zoe&ERTP -Zoe合同框架和ERTP资产处理
  • 编排 -跨链编排能力
  • 耐久性 -用于升级安全合约的持久对象模式
  • 测试 -合同测试工具和模式
  • 调试和跟踪 -调试和跟踪合同执行
  • 安全 -安全最佳实践和漏洞检查
  • 发现与帮助 -文档和API发现

快速入门(克劳德代码)

claude mcp add --transport sse agoric-dev https://agoric-dev-mcp.agoric-core.workers.dev/sse

对于当地发展,使用 http://localhost:8787/sse 相反。

在当地发展

# install dependencies
yarn install

# run locally
yarn start

你应该能够打开 http://localhost:8787/ 在浏览器中

将MCP检查器连接到您的服务器

要探索新的MCP api,您可以使用 MCP检查员.

  • 从以下内容开始 npx @modelcontextprotocol/inspector
  • 在检查员内部,将“传输类型”切换为 SSE 并进入 http://localhost:8787/sse 作为要连接的MCP服务器的URL,然后单击“连接”
  • 您将导航到(模拟)用户/密码登录屏幕。输入任何电子邮件并通过登录。
  • 您应该被重定向回MCP检查器,现在您可以列出并调用任何已定义的工具!

将Claude Desktop连接到本地MCP服务器

MCP检查员很棒,但我们真的想把它和克劳德联系起来!跟随 Anthropic的快速入门 在Claude Desktop中,转到“设置”>“开发人员”>“编辑配置”以查找您的配置文件。

在文本编辑器中打开该文件,并将其替换为以下配置:

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:8787/sse"]
    }
  }
}

这将运行一个本地代理,让Claude通过HTTP与您的MCP服务器通信

当您打开Claude时,浏览器窗口应该会打开并允许您登录。您应该在右下角看到可用的工具。如果提示正确,克劳德应该要求调用该工具。

部署到Cloudflare

  1. npx wrangler kv namespace create OAUTH_KV
  2. 按照指导将kv命名空间ID添加到 wrangler.jsonc
  3. npm run deploy

从远程MCP客户端调用新部署的远程MCP服务器

就像你在上面的“本地开发”中所做的那样,运行MCP检查器:

npx @modelcontextprotocol/inspector@latest

然后输入 workers.dev URL(例如: worker-name.account-name.workers.dev/sse)将检查器中的Worker设置为要连接的MCP服务器的URL,然后单击“连接”。

现在,您已从远程MCP客户端连接到MCP服务器。

将Claude Desktop连接到远程MCP服务器

更新Claude配置文件以指向您的 workers.dev URL(例如: worker-name.account-name.workers.dev/sse)并重新启动克劳德

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": ["mcp-remote", "https://worker-name.account-name.workers.dev/sse"]
    }
  }
}

调试

如果出现任何问题,重启Claude或尝试直接连接到您的 MCP服务器在命令行上使用以下命令。

npx mcp-remote http://localhost:8787/sse

在某些罕见的情况下,清除添加到的文件可能会有所帮助 ~/.mcp-auth

rm -rf ~/.mcp-auth