Openfort MCP Server

---

Openfort 模型上下文协议（MCP）服务

Openfort 是钱包基础设施解决方案的开源替代方案，可通过身份验证、用户管理和支付功能为你的项目赋能。

Openfort 的 MCP 服务是一款即插即用的解决方案，可增强 AI 助手的能力，使其在基于 Openfort 基础设施构建应用时，能够自动创建项目、管理配置和查询数据。以下是设置指南

功能

• 🔨 42 个工具 — 一套完整的工具，可与 Openfort 交互
• 🔐 身份验证 — 只需接入 MCP，即可直接进行身份验证
• 📄️ 初始化 — 通过聊天创建新的 Openfort 项目
• 🏗️ 脚手架 — 只需一条提示词，即可从头构建新应用
• 🔎 上下文 — 查询最新版本的文档
• 💳️ 创建 — 只需告诉大模型，即可生成钱包、用户、合约和策略

步骤

1. 安装 Openfort 的 MCP 服务。
2. 为大模型添加规则。
3. 创建新项目。
4. 调试常见问题。
5. 探索所有功能。

1. 安装 Openfort 的 MCP 服务

这将使你的 AI 助手能够代表你使用 Openfort 的工具来创建和管理项目。

请确保具备以下先决条件：

• Node.js - 安装指南在此
• 一个 Openfort account - 在此创建

现在，将其添加到你的代码编辑器中。根据你偏好的工具，按照以下说明操作：

---

Cursor

要将我们的 MCP 服务集成到 Cursor，你可以选择以下任一方式：

一键安装

编辑 ~/.cursor/mcp.json

你可以在系统中查找该文件，也可以在 Cursor Settings 中的 Tools & Integrations 选项卡下找到。填入以下内容：

  {
    "mcpServers": {
      "openfort-mcp": {
        "command": "npx",
        "args": [
          "mcp-remote",
          "https://mcp.openfort.io/sse"
        ]
      }
    }
  }

之后，无需重启，你就会在 Tools & Integrations 选项卡中看到 Openfort MCP 服务。身份验证将自动触发。

---

Windsurf

要与 Windsurf 集成，请将 ~/.codeium/windsurf/mcp_config.json 文件的内容替换为以下内容。文件位置：

Windsurf Settings > Cascade > Plugins (MCP Servers) > View Raw Config

适用于 MacOS/Linux

{
  "mcpServers": {
    "openfort-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.openfort.io/sse"
      ],
      "disabled": false
    }
  }
}

适用于 windows

{
  "mcpServers": {
    "openfort-mcp": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "mcp-remote",
        "https://mcp.openfort.io/sse"
        ],
      "disabled": false
    }
  }
}

---

Visual Studio Code

要将 MCP 服务集成到 VS Code，以便与 GitHub Copilot 配合使用，请编辑 .vscode/mcp.json 文件，或运行 MCP: Open User Configuration 命令打开配置文件，然后添加以下内容：

{
  "servers": {
    "openfort-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.openfort.io/sse"
      ]
    }
  }
}

---

Claude Desktop

要将我们的 MCP 服务添加到 Claude Desktop，请在 Settings 的 Developer 选项卡下点击 Edit Config，以自动创建以下文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

创建后，填入以下内容：

{
  "mcpServers": {
    "openfort-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.openfort.io/sse"
      ]
    }
  }
}

修改配置文件后，需要重启 Claude Desktop。此外，如果你刚安装了 Node.js，可能还需要重启电脑。

---

2. 为大模型添加规则

大模型往往会忘记工具的可用性，并可能出现一些异常行为。因此，最好添加规则来提醒它们。复制这里的规则，并将其添加到你的编辑器中。

3. 创建新项目

现在，在编辑器中新建一个项目，并输入提示词，让大模型为你搭建项目框架。需要时，大模型会自动调用 Openfort MCP 服务上的可用工具，提升你的开发体验。你可以在官方文档中找到提示词示例。

4. 排查常见问题

以下是你可能遇到的一些常见问题及其解决方法。

---

常见错误

Agent 完成项目创建后，即使提供了扩展上下文，项目仍可能报错。复杂的提示词或大型应用尤其容易出现这种情况。

不要期望 AI 仅凭一条提示词就能毫无问题地生成完整应用。

要解决这些错误，可以手动修复，也可以向 AI 寻求帮助。反复迭代很正常，请检查输出、进行修正，并根据需要继续输入提示词。

---

创建策略时陷入循环

有时，AI Agent 在创建策略时可能会陷入循环。策略已成功创建，但 Agent 会反复尝试用相同的值更新策略。

原因未知，但不会造成影响。

要解决此问题，只需取消生成，并提示 Agent 继续下一步。

---

npm 错误：缺少脚本："dev"

如果 AI Agent 无法通过 npm run dev 启动项目，通常是因为它在子文件夹中创建了项目，却没有在运行命令前切换到该目录。

手动切换到子文件夹，然后重新运行项目。

---

没有权限编辑 .env 文件

当 AI Agent 无法使用项目密钥编辑或创建 .env 文件时，通常是因为文件权限不足。

在 Cursor 中，添加 .cursorignore 文件并写入 !.env，明确允许 AI 编辑 .env 文件。

对于其他编辑器或环境，请采用等效方法，确保该文件未被忽略。

---

5. 了解所有功能

如需详细了解可用工具及其用法，请查看 MCP 服务文档。