mcp-server-js

 <div align="center"> [](https://npmjs.org/package/@yepcode/mcp-server) [](https://www.npmjs.com/package/@yepcode/mcp-server) [](https://github.com/yepcode/mcp-server-js/actions) [](https://archestra.ai/mcp-catalog/yepcode__mcp-server-js) [](https://smithery.ai/server/@yepcode/mcp-server) </div> ## What is YepCode MCP Server? An MCP ([Model Context Protocol](https://modelcontextprotocol.io/introduction)) server that enables AI platforms to interact with [YepCode](https://yepcode.io/l/LQUKe)'s infrastructure. Run LLM generated scripts and turn your YepCode processes into powerful tools that AI assistants can use directly. ### Why YepCode MCP Server? - **Seamless AI Integration**: Convert YepCode processes into AI-ready tools with zero configuration - **Real-time Process Control**: Enable direct interaction between AI systems and your workflows - **Enterprise-Grade Security**: Execute code in YepCode's isolated, production-ready environments - **Universal Compatibility**: Integrate with any AI platform supporting the Model Context Protocol ## Integration Guide YepCode MCP server can be integrated with AI platforms like [Cursor](https://cursor.sh) or [Claude Desktop](https://www.anthropic.com/news/claude-desktop) using either a remote approach (we offer a hosted version of the MCP server) or a local approach (NPX or Docker installation is required). For both approaches, you need to get your YepCode API credentials: 1. Sign up to [YepCode Cloud](https://yepcode.io/l/LQUKe) 2. Visit `Settings` > `API credentials` to create a new API token. ### Remote Approach using SSE Server - If your MCP Client doesn't support authentication headers, just use the SSE server URL that includes the API Token. Use a configuration similar to the following: ```typescript { "mcpServers": { "yepcode-mcp-server": { "url": "https://cloud.yepcode.io/mcp/sk-c2E....RD/sse" } } } ``` - If your MCP Client supports authentication headers, you can use the HTTP server URL that includes the API Token. Use a configuration similar to the following: ```typescript { "mcpServers": { "yepcode-mcp-server": { "url": "https://cloud.yepcode.io/mcp/sse", "headers": { "Authorization": "Bearer <sk-c2E....RD>" } } } } ``` ### Local Approach #### Using NPX Make sure you have Node.js installed (version 18 or higher), and use a configuration similar to the following: ```typescript { "mcpServers": { "yepcode-mcp-server": { "command": "npx", "args": ["-y", "@yepcode/mcp-server"], "env": { "YEPCODE_API_TOKEN": "your_api_token_here" } } } } ``` #### Using Docker 1. Build the container image: ```bash docker build -t yepcode/mcp-server . ``` 2. Use a configuration similar to the following: ```typescript { "mcpServers": { "yepcode-mcp-server": { "command": "docker", "args": [ "run", "-d", "-e", "YEPCODE_API_TOKEN=your_api_token_here", "yepcode/mcp-server" ] } } } ``` ## Debugging Debugging MCP servers can be tricky since they communicate over stdio. To make this easier, we recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector), which you can run with the following command: ```bash npm run inspector ``` This will start a server where you can access debugging tools directly in your browser. ## YepCode MCP Tools Reference The MCP server provides several tools to interact with YepCode's infrastructure: ### Code Execution #### run_code Executes code in YepCode's secure environment. ```typescript // Input { code: string; // The code to execute options?: { language?: string; // Programming language (default: 'javascript') comment?: string; // Execution context settings?: Record<string, unknown>; // Runtime settings } } // Response { returnValue?: unknown; // Execution result logs?: string[]; // Console output error?: string; // Error message if execution failed } ``` ##### MCP Options YepCode MCP server supports the following options: - `runCodeCleanup`: Skip the run_code cleanup. By default, run_code processes source code is removed after execution. If you want to keep it for audit purposes, you can use this option. Options can be passed as a comma-separated list in the `YEPCODE_MCP_OPTIONS` environment variable. ##### Tool Selection You can control which tools are enabled by setting the `YEPCODE_MCP_TOOLS` environment variable with a comma-separated list of tool categories and process tags: **Built-in tool categories:** - `run_code`: Enables the code execution tool - `yc_api`: Enables all basic API management tools (processes, schedules, variables, storage, executions, modules) - `yc_api_full`: Enables all API management tools including version-related tools (extends `yc_api` with additional process and module version management tools) - any specific API tool name (e.g., `execute_process_sync`, `get_execution`,...) **Process tags:** - Any tag used in your YepCode processes (e.g., `mcp-tool`, `core`, `automation`, etc.) - When you specify a process tag, all processes with that tag will be exposed as individual MCP tools - Process tools will be named using the process slug (or prefixed with `yc_` and the process ID if the name is longer than 60 characters) If not specified, all built-in tools are enabled by default, but no process tools will be exposed. ```typescript // SSE server configuration with options { "mcpServers": { "yepcode-mcp-server": { "url": "https://cloud.yepcode.io/mcp/sk-c2E....RD/sse?mcpOptions=runCodeCleanup&tools=run_code,yc_api,mcp-tool,core" } } } // NPX configuration with options { "mcpServers": { "yepcode-mcp-server": { "command": "npx", "args": ["-y", "@yepcode/mcp-server"], "env": { "YEPCODE_API_TOKEN": "your_api_token_here", "YEPCODE_MCP_OPTIONS": "runCodeCleanup", "YEPCODE_MCP_TOOLS": "run_code,yc_api,mcp-tool,core" } } } } ``` **Example scenarios:** - `YEPCODE_MCP_TOOLS=run_code,yc_api` - Enables built-in code execution and basic API management tools - `YEPCODE_MCP_TOOLS=run_code,yc_api_full` - Enables built-in code execution and all API management tools (including version management) - `YEPCODE_MCP_TOOLS=core,automation` - Only exposes processes tagged with "core" or "automation" as tools - `YEPCODE_MCP_TOOLS=run_code,yc_api,core` - Enables built-in tools plus all processes tagged with "core" ### Environment Management #### set_env_var Sets an environment variable in the YepCode workspace. ```typescript // Input { key: string; // Variable name value: string; // Variable value isSensitive?: boolean; // Whether to mask the value in logs (default: true) } ``` #### remove_env_var Removes an environment variable from the YepCode workspace. ```typescript // Input { key: string; // Name of the variable to remove } ``` ### Storage Management YepCode provides a built-in storage system that allows you to upload, list, download, and delete files. These files can be accessed from your code executions using the `yepcode.storage` helper methods. #### list_files Lists all files in your YepCode storage. ```typescript // Input { prefix?: string; // Optional prefix to filter files } // Response { files: Array<{ filename: string; // File name or path size: number; // File size in bytes lastModified: string; // Last modification date }>; } ``` #### upload_file Uploads a file to YepCode storage. ```typescript // Input { filename: string; // File path (e.g., 'file.txt' or 'folder/file.txt') content: string | { // File content data: string; // Base64 encoded content for binary files encoding: "base64"; }; } // Response { success: boolean; // Upload success status filename: string; // Uploaded file path } ``` #### download_file Downloads a file from YepCode storage. ```typescript // Input { filename: string; // File path to download } // Response { filename: string; // File path content: string; // File content (base64 for binary files) encoding?: string; // Encoding type if binary } ``` #### delete_file Deletes a file from YepCode storage. ```typescript // Input { filename: string; // File path to delete } // Response { success: boolean; // Deletion success status filename: string; // Deleted file path } ``` ### Process Execution The MCP server can expose your YepCode Processes as individual MCP tools, making them directly accessible to AI assistants. This feature is enabled by specifying process tags in the `YEPCODE_MCP_TOOLS` environment variable. **How it works:** 1. Tag your YepCode processes with any tag (e.g., `core`, `api`, `automation`, `mcp-tool`, etc.) 2. Add those tags to the `YEPCODE_MCP_TOOLS` environment variable 3. All processes with the specified tags will be exposed as individual MCP tools There will be a tool for each exposed process named using the process slug (or prefixed with `yc_` and the process ID if the tool name is longer than 60 characters). For more information about process tags, see our [process tags documentation](https://yepcode.io/docs/processes/tags). #### <process_slug> ```typescript // Input { parameters?: any; // This should match the input parameters specified in the process options?: { tag?: string; // Process version to execute comment?: string; // Execution context }; synchronousExecution?: boolean; // Whether to wait for completion (default: true) } // Response (synchronous execution) { executionId: string; // Unique execution identifier logs: string[]; // Process execution logs returnValue?: unknown; // Process output error?: string; // Error message if execution failed } // Response (asynchronous execution) { executionId: string; // Unique execution identifier } ``` ### API Management Tools The API management tool categories (`yc_api` and `yc_api_full`) provide comprehensive API access to manage all aspects of your YepCode workspace: **Basic API tools (`yc_api`):** The `yc_api` tag enables standard API management tools for core operations across your workspace. **Extended API tools (`yc_api_full`):** The `yc_api_full` tag includes everything from `yc_api` plus additional tools for managing process and module versions. **Processes Management:** - `get_processes` - List processes with optional filtering - `create_process` - Create new processes with source code - `get_process` - Get process details - `update_process` - Update an existing process - `delete_process` - Delete a process - `get_process_versions` - Get process versions (requires `yc_api_full`) - `execute_process_async` - Execute a process asynchronously - `execute_process_sync` - Execute a process synchronously - `schedule_process` - Schedule a process to run automatically **Schedules Management:** - `get_schedules` - List scheduled processes - `get_schedule` - Get schedule details - `pause_schedule` - Pause a scheduled process - `resume_schedule` - Resume a paused schedule - `delete_schedule` - Delete a schedule - `update_schedule` - Update a scheduled process **Variables Management:** - `get_variables` - List team variables - `create_variable` - Create a new variable - `update_variable` - Update an existing variable - `delete_variable` - Delete a variable **Storage Management:** - `get_storage_objects` - List storage objects - `upload_storage_object` - Upload a file to storage - `download_storage_object` - Download a file from storage - `delete_storage_object` - Delete a file from storage **Executions Management:** - `get_executions` - List executions with optional filtering - `get_execution` - Get execution details from API - `kill_execution` - Kill a running execution - `rerun_execution` - Rerun a previous execution - `get_execution_logs` - Get execution logs **Modules Management:** - `get_modules` - List script library modules - `create_module` - Create a new module - `get_module` - Get module details - `delete_module` - Delete a module - `get_module_versions` - Get module versions (requires `yc_api_full`) - `get_module_version` - Get a specific module version (requires `yc_api_full`) - `delete_module_version` - Delete a module version (requires `yc_api_full`) - `get_module_aliases` - Get module version aliases (requires `yc_api_full`) ## License This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.