{"id":26896418,"url":"https://github.com/yepcode/mcp-server-js","last_synced_at":"2026-02-05T14:17:54.009Z","repository":{"id":284737647,"uuid":"955424433","full_name":"yepcode/mcp-server-js","owner":"yepcode","description":"An MCP (Model Context Protocol) server that enables ✨ AI platforms to interact with 🤖 YepCode's infrastructure.  Turn your YepCode processes into powerful tools that AI assistants can use 🚀","archived":false,"fork":false,"pushed_at":"2025-11-27T11:21:05.000Z","size":924,"stargazers_count":40,"open_issues_count":1,"forks_count":18,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-11-30T03:10:39.394Z","etag":null,"topics":["agent","ai","ai-agent","ai-agents","mcp-server","yepcode"],"latest_commit_sha":null,"homepage":"https://yepcode.io","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yepcode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-26T16:05:56.000Z","updated_at":"2025-11-27T11:21:09.000Z","dependencies_parsed_at":"2025-04-21T13:25:15.339Z","dependency_job_id":"1672e7c5-e00f-4d83-9dd9-ac1a276b1ac0","html_url":"https://github.com/yepcode/mcp-server-js","commit_stats":null,"previous_names":["yepcode/mcp-server-js"],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/yepcode/mcp-server-js","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yepcode%2Fmcp-server-js","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yepcode%2Fmcp-server-js/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yepcode%2Fmcp-server-js/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yepcode%2Fmcp-server-js/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yepcode","download_url":"https://codeload.github.com/yepcode/mcp-server-js/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yepcode%2Fmcp-server-js/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29123675,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T14:05:12.718Z","status":"ssl_error","status_checked_at":"2026-02-05T14:03:53.078Z","response_time":65,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","ai","ai-agent","ai-agents","mcp-server","yepcode"],"created_at":"2025-04-01T03:44:09.609Z","updated_at":"2026-02-05T14:17:54.001Z","avatar_url":"https://github.com/yepcode.png","language":"TypeScript","funding_links":[],"categories":["Sandboxing \u0026 Execution","🏢 Enterprise-Supported Implementations","CI/CD \u0026 DevOps Pipelines","Code Execution \u0026 Automation MCP Servers","📚 Projects (1974 total)","MCP 服务器精选列表","🤖 AI/ML","サーバー実装","Cloud Services","Official Servers","Code Execution","MCP Servers \u0026 Protocol"],"sub_categories":["Wiki \u0026 Collaboration","Data \u0026 Web Services","👨‍💻 Code Execution","MCP Servers","💻 开发与代码执行","👨‍💻 \u003ca name=\"code-execution\"\u003e\u003c/a\u003eコード実行","How to Submit"],"readme":"![YepCode MCP Server Preview](https://yepcode.io/images/cover/yepcode-ultimate-dev-tool-ai-solutions.png)\n\n\u003cdiv align=\"center\"\u003e\n\n[![NPM version](https://img.shields.io/npm/v/@yepcode/mcp-server.svg)](https://npmjs.org/package/@yepcode/mcp-server)\n[![NPM Downloads](https://img.shields.io/npm/dm/@yepcode/mcp-server)](https://www.npmjs.com/package/@yepcode/mcp-server)\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/yepcode/mcp-server-js/ci.yml)](https://github.com/yepcode/mcp-server-js/actions)\n\n[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/yepcode/mcp-server-js)](https://archestra.ai/mcp-catalog/yepcode__mcp-server-js)\n[![smithery badge](https://smithery.ai/badge/@yepcode/mcp-server)](https://smithery.ai/server/@yepcode/mcp-server)\n\n\u003c/div\u003e\n\n## What is YepCode MCP Server?\n\nAn 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.\n\n### Why YepCode MCP Server?\n\n- **Seamless AI Integration**: Convert YepCode processes into AI-ready tools with zero configuration\n- **Real-time Process Control**: Enable direct interaction between AI systems and your workflows\n- **Enterprise-Grade Security**: Execute code in YepCode's isolated, production-ready environments\n- **Universal Compatibility**: Integrate with any AI platform supporting the Model Context Protocol\n\n## Integration Guide\n\nYepCode 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).\n\nFor both approaches, you need to get your YepCode API credentials:\n\n1. Sign up to [YepCode Cloud](https://yepcode.io/l/LQUKe)\n2. Visit `Settings` \u003e `API credentials` to create a new API token.\n\n### Remote Approach using SSE Server\n\n- 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:\n\n```typescript\n{\n  \"mcpServers\": {\n    \"yepcode-mcp-server\": {\n      \"url\": \"https://cloud.yepcode.io/mcp/sk-c2E....RD/sse\"\n    }\n  }\n}\n```\n\n- 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:\n\n```typescript\n{\n  \"mcpServers\": {\n    \"yepcode-mcp-server\": {\n      \"url\": \"https://cloud.yepcode.io/mcp/sse\",\n      \"headers\": {\n        \"Authorization\": \"Bearer \u003csk-c2E....RD\u003e\"\n      }\n    }\n  }\n}\n```\n\n### Local Approach\n\n#### Using NPX\n\nMake sure you have Node.js installed (version 18 or higher), and use a configuration similar to the following:\n\n```typescript\n{\n  \"mcpServers\": {\n    \"yepcode-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@yepcode/mcp-server\"],\n      \"env\": {\n        \"YEPCODE_API_TOKEN\": \"your_api_token_here\"\n      }\n    }\n  }\n}\n```\n\n#### Using Docker\n\n1. Build the container image:\n\n```bash\ndocker build -t yepcode/mcp-server .\n```\n\n2. Use a configuration similar to the following:\n\n```typescript\n{\n  \"mcpServers\": {\n    \"yepcode-mcp-server\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-d\",\n        \"-e\",\n        \"YEPCODE_API_TOKEN=your_api_token_here\",\n        \"yepcode/mcp-server\"\n      ]\n    }\n  }\n}\n```\n\n## Debugging\n\nDebugging 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:\n\n```bash\nnpm run inspector\n```\n\nThis will start a server where you can access debugging tools directly in your browser.\n\n## YepCode MCP Tools Reference\n\nThe MCP server provides several tools to interact with YepCode's infrastructure:\n\n### Code Execution\n\n#### run_code\n\nExecutes code in YepCode's secure environment.\n\n```typescript\n// Input\n{\n  code: string;                          // The code to execute\n  options?: {\n    language?: string;                   // Programming language (default: 'javascript')\n    comment?: string;                    // Execution context\n    settings?: Record\u003cstring, unknown\u003e;  // Runtime settings\n  }\n}\n\n// Response\n{\n  returnValue?: unknown;                 // Execution result\n  logs?: string[];                       // Console output\n  error?: string;                        // Error message if execution failed\n}\n```\n\n##### MCP Options\n\nYepCode MCP server supports the following options:\n\n- `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.\n- `skipCodingRules`: Skip including coding rules in the run_code tool definition. By default, JavaScript and Python coding rules from YepCode documentation are included in the tool schema to guide AI-generated code. If you want to skip this for faster tool initialization or smaller tool definitions, you can use this option.\n\nOptions can be passed as a comma-separated list in the `YEPCODE_MCP_OPTIONS` environment variable.\n\n##### Tool Selection\n\nYou 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:\n\n**Built-in tool categories:**\n- `run_code`: Enables the code execution tool\n- `yc_api`: Enables all basic API management tools (processes, schedules, variables, storage, executions, modules)\n- `yc_api_full`: Enables all API management tools including version-related tools (extends `yc_api` with additional process and module version management tools)\n- any specific API tool name (e.g., `execute_process_sync`, `get_execution`,...)\n\n**Process tags:**\n- Any tag used in your YepCode processes (e.g., `mcp-tool`, `core`, `automation`, etc.)\n- When you specify a process tag, all processes with that tag will be exposed as individual MCP tools\n- 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)\n\nIf not specified, all built-in tools are enabled by default, but no process tools will be exposed.\n\n```typescript\n// SSE server configuration with options\n{\n  \"mcpServers\": {\n    \"yepcode-mcp-server\": {\n      \"url\": \"https://cloud.yepcode.io/mcp/sk-c2E....RD/sse?mcpOptions=runCodeCleanup\u0026tools=run_code,yc_api,mcp-tool,core\"\n    }\n  }\n}\n\n// NPX configuration with options\n{\n  \"mcpServers\": {\n    \"yepcode-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@yepcode/mcp-server\"],\n      \"env\": {\n        \"YEPCODE_API_TOKEN\": \"your_api_token_here\",\n        \"YEPCODE_MCP_OPTIONS\": \"runCodeCleanup,skipCodingRules\",\n        \"YEPCODE_MCP_TOOLS\": \"run_code,yc_api,mcp-tool,core\"\n      }\n    }\n  }\n}\n```\n\n**Example scenarios:**\n- `YEPCODE_MCP_TOOLS=run_code,yc_api` - Enables built-in code execution and basic API management tools\n- `YEPCODE_MCP_TOOLS=run_code,yc_api_full` - Enables built-in code execution and all API management tools (including version management)\n- `YEPCODE_MCP_TOOLS=core,automation` - Only exposes processes tagged with \"core\" or \"automation\" as tools\n- `YEPCODE_MCP_TOOLS=run_code,yc_api,core` - Enables built-in tools plus all processes tagged with \"core\"\n\n### Environment Management\n\n#### set_env_var\n\nSets an environment variable in the YepCode workspace.\n\n```typescript\n// Input\n{\n  key: string;                           // Variable name\n  value: string;                         // Variable value\n  isSensitive?: boolean;                 // Whether to mask the value in logs (default: true)\n}\n```\n\n#### remove_env_var\n\nRemoves an environment variable from the YepCode workspace.\n\n```typescript\n// Input\n{\n  key: string;                           // Name of the variable to remove\n}\n```\n\n### Storage Management\n\nYepCode 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.\n\n#### list_files\n\nLists all files in your YepCode storage.\n\n```typescript\n// Input\n{\n  prefix?: string;                       // Optional prefix to filter files\n}\n\n// Response\n{\n  files: Array\u003c{\n    filename: string;                    // File name or path\n    size: number;                        // File size in bytes\n    lastModified: string;                // Last modification date\n  }\u003e;\n}\n```\n\n#### upload_file\n\nUploads a file to YepCode storage.\n\n```typescript\n// Input\n{\n  filename: string;                      // File path (e.g., 'file.txt' or 'folder/file.txt')\n  content: string | {                   // File content\n    data: string;                        // Base64 encoded content for binary files\n    encoding: \"base64\";\n  };\n}\n\n// Response\n{\n  success: boolean;                      // Upload success status\n  filename: string;                      // Uploaded file path\n}\n```\n\n#### download_file\n\nDownloads a file from YepCode storage.\n\n```typescript\n// Input\n{\n  filename: string;                      // File path to download\n}\n\n// Response\n{\n  filename: string;                      // File path\n  content: string;                       // File content (base64 for binary files)\n  encoding?: string;                     // Encoding type if binary\n}\n```\n\n#### delete_file\n\nDeletes a file from YepCode storage.\n\n```typescript\n// Input\n{\n  filename: string;                      // File path to delete\n}\n\n// Response\n{\n  success: boolean;                      // Deletion success status\n  filename: string;                      // Deleted file path\n}\n```\n\n### Process Execution\n\nThe 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.\n\n**How it works:**\n1. Tag your YepCode processes with any tag (e.g., `core`, `api`, `automation`, `mcp-tool`, etc.)\n2. Add those tags to the `YEPCODE_MCP_TOOLS` environment variable\n3. All processes with the specified tags will be exposed as individual MCP tools\n\nThere 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).\n\nFor more information about process tags, see our [process tags documentation](https://yepcode.io/docs/processes/tags).\n\n#### \u003cprocess_slug\u003e\n\n```typescript\n// Input\n{\n  parameters?: any;                      // This should match the input parameters specified in the process\n  options?: {\n    tag?: string;                        // Process version to execute\n    comment?: string;                    // Execution context\n  };\n  synchronousExecution?: boolean;        // Whether to wait for completion (default: true)\n}\n\n// Response (synchronous execution)\n{\n  executionId: string;                   // Unique execution identifier\n  logs: string[];                        // Process execution logs\n  returnValue?: unknown;                 // Process output\n  error?: string;                        // Error message if execution failed\n}\n\n// Response (asynchronous execution)\n{\n  executionId: string;                   // Unique execution identifier\n}\n```\n\n### API Management Tools\n\nThe API management tool categories (`yc_api` and `yc_api_full`) provide comprehensive API access to manage all aspects of your YepCode workspace:\n\n**Basic API tools (`yc_api`):**\nThe `yc_api` tag enables standard API management tools for core operations across your workspace.\n\n**Extended API tools (`yc_api_full`):**\nThe `yc_api_full` tag includes everything from `yc_api` plus additional tools for managing process and module versions.\n\n**Processes Management:**\n- `get_processes` - List processes with optional filtering\n- `create_process` - Create new processes with source code\n- `get_process` - Get process details\n- `update_process` - Update an existing process\n- `delete_process` - Delete a process\n- `get_process_versions` - Get process versions (requires `yc_api_full`)\n- `execute_process_async` - Execute a process asynchronously\n- `execute_process_sync` - Execute a process synchronously\n- `schedule_process` - Schedule a process to run automatically\n\n**Schedules Management:**\n- `get_schedules` - List scheduled processes\n- `get_schedule` - Get schedule details\n- `pause_schedule` - Pause a scheduled process\n- `resume_schedule` - Resume a paused schedule\n- `delete_schedule` - Delete a schedule\n- `update_schedule` - Update a scheduled process\n\n**Variables Management:**\n- `get_variables` - List team variables\n- `create_variable` - Create a new variable\n- `update_variable` - Update an existing variable\n- `delete_variable` - Delete a variable\n\n**Storage Management:**\n- `get_storage_objects` - List storage objects\n- `upload_storage_object` - Upload a file to storage\n- `download_storage_object` - Download a file from storage\n- `delete_storage_object` - Delete a file from storage\n\n**Executions Management:**\n- `get_executions` - List executions with optional filtering\n- `get_execution` - Get execution details from API\n- `kill_execution` - Kill a running execution\n- `rerun_execution` - Rerun a previous execution\n- `get_execution_logs` - Get execution logs\n\n**Modules Management:**\n- `get_modules` - List script library modules\n- `create_module` - Create a new module\n- `get_module` - Get module details\n- `delete_module` - Delete a module\n- `get_module_versions` - Get module versions (requires `yc_api_full`)\n- `get_module_version` - Get a specific module version (requires `yc_api_full`)\n- `delete_module_version` - Delete a module version (requires `yc_api_full`)\n- `get_module_aliases` - Get module version aliases (requires `yc_api_full`)\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyepcode%2Fmcp-server-js","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyepcode%2Fmcp-server-js","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyepcode%2Fmcp-server-js/lists"}