Superface MCP Server

Superface MCP Server

site icon
2025.04.11 4
JavaScript开发工具集成API 集成开发效率
Superface MCP Server 是一个通过 Model Context Protocol (MCP) 提供 Superface 工具集成的服务。它允许开发者通过简单的配置将 Superface 的工具集成到他们的开发环境中,如 Claude Desktop。
View on GitHub

Overview

基本能力

产品定位

Superface MCP Server 是一个开发工具集成服务,通过 MCP 协议提供 Superface 的工具能力。

核心功能

  • 通过 MCP 协议集成 Superface 工具
  • 支持通过 NPX 或 Docker 快速启动服务
  • 提供 API Key 配置,用于工具授权

适用场景

  • 开发者希望在 Claude Desktop 等开发环境中集成 Superface 工具
  • 需要快速调用 Superface 提供的各种 API 能力

工具列表

  • @superfaceai/mcp: 通过 NPX 运行的 MCP 服务工具
  • mcp/superface: 通过 Docker 运行的 MCP 服务镜像

常见问题解答

  • 如何获取 API Key: 通过 Superface dashboard 获取
  • 如何配置: 通过编辑 claude_desktop_config.json 文件进行配置

使用教程

使用依赖

  • Node.js (用于 NPX 方式)
  • Docker (用于 Docker 方式)

安装教程

NPX 方式

  1. 确保已安装 Node.js
  2. 在配置文件中添加以下内容:
{
  "mcpServers": {
    "superface": {
      "command": "npx",
      "args": [
        "-y",
        "@superfaceai/mcp"
      ],
      "env": {
        "SUPERFACE_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Docker 方式

  1. 确保已安装 Docker
  2. 构建镜像:
docker build -t mcp/superface .
  1. 在配置文件中添加以下内容:
{
  "mcpServers": {
    "superface": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SUPERFACE_API_KEY",
        "mcp/superface"
      ],
      "env": {
        "SUPERFACE_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

调试方式

  • 检查 API Key 是否正确配置
  • 确保 NPX 或 Docker 命令可正常执行
  • 检查配置文件路径是否正确

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。