Motoko MCP服务器模板

一个为ICP Ninja在线IDE提供的即用型Motoko MCP服务器模板,支持快速部署和测试,适用于Prometheus Protocol生态系统。

  • by B0N4N24
  • Motoko
  • 本地部署
  • 更新于
在 GitHub 查看 B0N4N24/My-Awesome-MCP-Server

使用说明

ICP Ninja的Motoko MCP服务器模板

欢迎!此模板提供了一个完整且可随时部署的Motoko MCP服务器 “Prometheus Protocol”翻译成中文是“普罗米修斯协议” 生态系统,专为ICP Ninja在线集成开发环境(IDE)设计。

无需在您的机器上安装任何东西即可开始。让我们开始吧。

立即在ICP Ninja启动:https://icp.ninja/i?s=wOrZM


ICP Ninja工作流程

在这个集成开发环境(IDE)中,你不需要使用终端来进行部署。相反,你有两个主要按钮:

  • **Run**将您的服务器部署到 临时的 罐体。这个罐体是免费的,非常适合用于测试,但45分钟后它会自动销毁。
  • **Publish**将您的服务器部署到 永久的 你控制的容器。要使用它,你需要拥有一个ICP账户以及为你的应用程序提供动力的周期(cycles)。

第一部分:快速入门(60秒内完成部署)

本节内容将在几分钟内帮助您的服务器上线并进行测试。

第一步:部署一个临时服务器

点击 Run ICP Ninja界面上的按钮。

等待部署过程完成。您将在控制台面板中看到输出结果,其中包括您的新临时罐(canister)ID。

步骤2:使用MCP检查器进行测试

您的服务器现已默认启动 get_weather 工具。我们来测试一下。

  1. 复制你的罐体ID 从部署输出面板中。
  2. 构建MCP服务器URL: 创建一个符合以下格式的URL:
    https://[YOUR_CANISTER_ID].icp0.io/mcp
    
  3. 运行MCP检查器在您的终端中运行:
    npx @modelcontextprotocol/inspector
    
  4. 打开网址MCP 检查器将打开一个浏览器标签页。在框中输入您的 MCP 服务器的 URL,然后点击“连接”。现在,您可以列出并获取资源和工具,并调用 get_weather 工具(剧透警告,总是阳光明媚!)。

🎉 恭喜! 您已在Internet Computer上运行了一个正常工作的MCP服务器。


第二部分:解锁高级功能(本地开发)

ICP Ninja IDE 非常适合快速部署和测试。然而,要解锁诸如(以下功能)之类的特性 货币化(OAuth) 并且 发布到Prometheus应用商店你需要下载这个项目,并在你的本地机器上进行操作。

以下是对这一过程的简要概述。

本地开发的先决条件

如果你决定下载代码,你的系统上需要安装以下工具:

  1. DFX: DFINITY Canister SDK(DFINITY 可执行容器软件开发工具包)。 安装指南。
  2. Node.js: 版本18.0或更高版本。 下载。
  3. MOPS:(此处“MOPS”可能是一个特定领域或上下文中的缩写或术语,没有直接的中文翻译,但根据常见用法,可理解为“一种特定的物质、方法或系统”,具体需结合上下文确定。若“MOPS”在某个特定领域有固定译名,则应使用该译名。) Motoko包管理器。 安装指南。

实现盈利变现 💰

准备好添加付费工具了吗?此过程需要启用Prometheus OAuth流程。

  1. 激活授权码: 在 src/main.mo,你会取消注释初始化那块代码 authContext.
  2. 部署更改: 跑 dfx deploy (或 npm run deploy) 从您的本地终端。
  3. 在认证服务器上注册: 使用内置脚本将您的服务器注册为Prometheus认证服务器的客户端。
    # This command is run locally, not in the IDE
    npm run auth register
    

发布到Prometheus应用商店🚀

为了让您的服务器可被发现,您可以提交以进行验证。

  1. 初始化清单: 一个命令行向导帮助您创建 prometheus.yml 清单文件。
    # Run locally
    npm run app-store init
    
  2. 提交以进行验证: 一旦您的清单(包括Git提交哈希)准备完毕,您就可以提交进行审核。
    # Run locally
    npm run app-store submit
    
  3. 发布WASM(WebAssembly): 审核成功后,您将最终的、经过验证的代码发布到Prometheus注册表中。
    # Run locally
    npm run app-store -- publish --app-version "0.1.0"
    

接下来是什么?

  • 定制您的工具: 开放 src/main.mo 看看如何 echo 工具已构建完毕,现在开始创建您自己的自定义MCP工具。
  • 了解更多: 查看一下 Motoko MCP SDK 文档 用于高级功能。

祝你编程愉快!