Mcp Server Js

<div align="center">

</div>

什么是 YepCode MCP Server？

一个 MCP (模型上下文协议) 服务器，使 AI 平台能够与 YepCode 的基础设施进行交互。运行 LLM 生成的脚本，并将您的 YepCode 流程转化为 AI 助手可以直接使用的强大工具。

为什么选择 YepCode MCP Server？

• 无缝 AI 集成：将 YepCode 流程转换为 AI 就绪工具，无需任何配置
• 实时流程控制：实现 AI 系统与您的工作流程之间的直接交互
• 企业级安全性：在 YepCode 隔离的、生产就绪的环境中执行代码
• 通用兼容性：与任何支持模型上下文协议的 AI 平台集成

集成指南

YepCode MCP 服务器可以与 AI 平台（如 Cursor 或 Claude Desktop）集成，可以使用远程方法（我们提供 MCP 服务器的托管版本）或本地方法（需要 NPX 或 Docker 安装）。

使用 SSE 服务器的远程方法

1. 注册 YepCode Cloud
2. 从您的工作区中的 Settings > API credentials 获取您的 MCP 服务器 URL。
3. 将以下配置添加到您的 AI 平台设置：

{
  "mcpServers": {
    "yepcode-mcp-server": {
      "url": "https://cloud.yepcode.io/mcp/sk-c2E....RD/sse"
    }
  }
}

本地方法

必需的环境变量

• YEPCODE_API_TOKEN：您的 YepCode API 令牌。如何获取：
  1. 注册 YepCode Cloud
  2. 从您的工作区中的 Settings > API credentials 获取您的 API 令牌

使用 NPX

将以下配置添加到您的 AI 平台设置：

{
  "mcpServers": {
    "yepcode-mcp-server": {
      "command": "npx",
      "args": ["-y", "@yepcode/mcp-server"],
      "env": {
        "YEPCODE_API_TOKEN": "your_api_token_here",
      }
    }
  }
}

使用 Docker

1. 构建容器镜像：

docker build -t yepcode/mcp-server .

2. 将以下配置添加到您的 AI 平台设置：

{
  "mcpServers": {
    "yepcode-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-d",
        "-e",
        "YEPCODE_API_TOKEN=your_api_token_here",
        "yepcode/mcp-server"
      ]
    }
  }
}

调试

调试 MCP 服务器可能比较棘手，因为它们通过 stdio 进行通信。为了简化此过程，我们建议使用 MCP Inspector，您可以使用以下命令运行它：

npm run inspector

这将启动一个服务器，您可以在浏览器中直接访问调试工具。

YepCode MCP 工具参考

MCP 服务器提供了几个工具来与 YepCode 的基础设施进行交互：

代码执行

run_code

在 YepCode 的安全环境中执行代码。

// Input
{
  code: string;                          // 要执行的代码
  options?: {
    language?: string;                   // 编程语言（默认：'javascript'）
    comment?: string;                    // 执行上下文
    settings?: Record<string, unknown>;  // 运行时设置
  }
}

// Response
{
  returnValue?: unknown;                 // 执行结果
  logs?: string[];                       // 控制台输出
  error?: string;                        // 如果执行失败，则显示错误消息
}

环境变量管理

set_env_var

在 YepCode 工作区中设置环境变量。

// Input
{
  key: string;                           // 变量名
  value: string;                         // 变量值
  isSensitive?: boolean;                 // 是否在日志中屏蔽该值（默认：true）
}

remove_env_var

从 YepCode 工作区中删除环境变量。

// Input
{
  key: string;                           // 要删除的变量的名称
}

流程执行

MCP 服务器可以将您的 YepCode 流程公开为单独的 MCP 工具，使 AI 助手可以直接访问它们。只需将 mcp-tool 标签添加到您的流程即可启用此功能（请参阅我们的文档以了解有关 流程标签 的更多信息）。

每个公开的流程都会有一个工具：run_ycp_<process_slug>（如果工具名称超过 60 个字符，则为 run_ycp_<process_id>）。

run_ycp_<process_slug>

// Input
{
  parameters?: any;                      // 这应该与流程中指定的输入参数匹配
  options?: {
    tag?: string;                        // 要执行的流程版本
    comment?: string;                    // 执行上下文
  };
  synchronousExecution?: boolean;        // 是否等待完成（默认：true）
}

// Response (同步执行)
{
  executionId: string;                   // 唯一的执行标识符
  logs: string[];                        // 流程执行日志
  returnValue?: unknown;                 // 流程输出
  error?: string;                        // 如果执行失败，则显示错误消息
}

// Response (异步执行)
{
  executionId: string;                   // 唯一的执行标识符
}

get_execution

检索流程执行的结果。

// Input
{
  executionId: string;                   // 要检索的执行的 ID
}

// Response
{
  executionId: string;                   // 唯一的执行标识符
  logs: string[];                        // 流程执行日志
  returnValue?: unknown;                 // 流程输出
  error?: string;                        // 如果执行失败，则显示错误消息
}

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。