Skip to content

Commit eb5e22e

Browse files
yfe404yfe404
authored
feat: mcp server for forevervm (#33)
1 parent d2884a3 commit eb5e22e

File tree

15 files changed

+8174
-0
lines changed

15 files changed

+8174
-0
lines changed

‎forevervm-mcp-server/.actor/actor.json‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
{
2+
"actorSpecification": 1,
3+
"name": "ForeverVM MCP Server",
4+
"title": "ForeverVM MCP Server",
5+
"description": "A Model Context Protocol server that integrates with ForeverVM for secure Python code execution in stateful sandboxes. Enables AI agents to create Python REPLs and execute code with persistent state.",
6+
"version": "0.0",
7+
"meta": {
8+
"templateId": "ts-mcp-server"
9+
},
10+
"input": "./input_schema.json",
11+
"dockerfile": "./Dockerfile",
12+
"readme": "./README.md",
13+
"categories": ["MCP servers"],
14+
"storages": {
15+
"dataset": {
16+
"actorSpecification": 1,
17+
"title": "Results",
18+
"description": "Dataset containing MCP server responses and execution logs.",
19+
"views": {
20+
"overview": {
21+
"title": "Overview",
22+
"transformation": {
23+
"fields": [
24+
"timestamp",
25+
"method",
26+
"tool",
27+
"status",
28+
"response"
29+
]
30+
}
31+
}
32+
}
33+
}
34+
}
35+
}

‎forevervm-mcp-server/.actor/input_schema.json‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
{
2+
"title": "ForeverVM MCP Server Input",
3+
"type": "object",
4+
"schemaVersion": 1,
5+
"properties": {
6+
"foreverVmToken": {
7+
"title": "ForeverVM API Token",
8+
"type": "string",
9+
"description": "Your ForeverVM API token. Get it from your ForeverVM account at https://forevervm.com",
10+
"editor": "textfield",
11+
"isSecret": true
12+
}
13+
}
14+
}

‎forevervm-mcp-server/.actor/pay_per_event.json‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
{
2+
"actor-start": {
3+
"eventTitle": "Actor Initialization Fee",
4+
"eventDescription": "Flat fee for starting an Actor run.",
5+
"eventPriceUsd": 0.001
6+
},
7+
"create-python-repl": {
8+
"eventTitle": "Python REPL Creation",
9+
"eventDescription": "Fee for creating a new Python REPL environment with ForeverVM",
10+
"eventPriceUsd": 0.005
11+
},
12+
"run-python-in-repl": {
13+
"eventTitle": "Python Code Execution",
14+
"eventDescription": "Fee for executing Python code in a REPL environment",
15+
"eventPriceUsd": 0.002
16+
}
17+
}

‎forevervm-mcp-server/.prettierrc‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
{
2+
"printWidth": 100,
3+
"tabWidth": 4,
4+
"useTabs": false,
5+
"semi": true,
6+
"singleQuote": true,
7+
"quoteProps": "as-needed",
8+
"trailingComma": "es5"
9+
}

‎forevervm-mcp-server/Dockerfile‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
# Use the official Node.js runtime as the base image
2+
FROM node:18-alpine
3+
4+
# Set the working directory inside the container
5+
WORKDIR /usr/src/app
6+
7+
# Copy package.json and package-lock.json (if available)
8+
COPY package*.json ./
9+
10+
# Install the dependencies
11+
RUN npm ci --only=production && npm cache clean --force
12+
13+
# Copy the rest of the application code
14+
COPY . .
15+
16+
# Build the TypeScript code
17+
RUN npm run build
18+
19+
# Make sure the main script is executable
20+
RUN chmod +x dist/main.js
21+
22+
# Expose the port the app runs on (default 3000)
23+
EXPOSE 3000
24+
25+
# Define the command to run the application
26+
CMD ["node", "dist/main.js"]

‎forevervm-mcp-server/LICENSE‎

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
MIT License
2+
3+
Copyright (c) 2025 yfe404
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.
22+
23+
---
24+
25+
This project builds upon the ForeverVM MCP Server:
26+
Original work Copyright (c) 2024 Jamsocket Inc.
27+
https://github.com/jamsocket/forevervm/tree/main/javascript/mcp-server

0 commit comments

Comments
 (0)