code-executor-mcp 1.0.1__tar.gz → 1.0.2__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- code_executor_mcp-1.0.2/.github/FUNDING.yml +8 -0
- code_executor_mcp-1.0.2/.github/workflows/mcp-smithery-publish.yml +40 -0
- code_executor_mcp-1.0.2/.github/workflows/test.yml +31 -0
- code_executor_mcp-1.0.2/.gitignore +10 -0
- code_executor_mcp-1.0.2/.mcp.json +122 -0
- code_executor_mcp-1.0.2/.well-known/mcp/server-card.json +64 -0
- code_executor_mcp-1.0.2/CODE_OF_CONDUCT.md +18 -0
- code_executor_mcp-1.0.2/CONTRIBUTING.md +21 -0
- code_executor_mcp-1.0.2/Dockerfile.glama +20 -0
- {code_executor_mcp-1.0.1 → code_executor_mcp-1.0.2}/PKG-INFO +1 -44
- code_executor_mcp-1.0.2/SECURITY.md +16 -0
- code_executor_mcp-1.0.2/glama.json +10 -0
- code_executor_mcp-1.0.2/mcp-wrapper.py +85 -0
- code_executor_mcp-1.0.2/package.json +30 -0
- {code_executor_mcp-1.0.1 → code_executor_mcp-1.0.2}/pyproject.toml +1 -2
- code_executor_mcp-1.0.2/pytest.ini +3 -0
- code_executor_mcp-1.0.2/server.json +22 -0
- {code_executor_mcp-1.0.1 → code_executor_mcp-1.0.2}/server.py +102 -6
- code_executor_mcp-1.0.2/smithery.yaml +65 -0
- code_executor_mcp-1.0.2/tests/test_server.py +55 -0
- {code_executor_mcp-1.0.1 → code_executor_mcp-1.0.2}/LICENSE +0 -0
- {code_executor_mcp-1.0.1 → code_executor_mcp-1.0.2}/README.md +0 -0
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# Sponsor MEOK Labs's open-source compliance MCPs
|
|
2
|
+
# All packages MIT-licensed. Supports the Sigstore migration + ongoing maintenance.
|
|
3
|
+
|
|
4
|
+
github: [CSOAI-ORG]
|
|
5
|
+
custom:
|
|
6
|
+
- "https://buy.stripe.com/eVq9AV4O87sudMF42k8k839"
|
|
7
|
+
- "https://meok.ai/sponsor"
|
|
8
|
+
- "https://nlnet.nl/propose"
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
name: Publish to Smithery
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
release:
|
|
5
|
+
types: [published]
|
|
6
|
+
|
|
7
|
+
permissions: {}
|
|
8
|
+
|
|
9
|
+
jobs:
|
|
10
|
+
publish:
|
|
11
|
+
name: Publish MCP Server to Smithery
|
|
12
|
+
runs-on: ubuntu-latest
|
|
13
|
+
permissions:
|
|
14
|
+
contents: read
|
|
15
|
+
attestations: write
|
|
16
|
+
id-token: write
|
|
17
|
+
steps:
|
|
18
|
+
- name: Checkout repository
|
|
19
|
+
uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
|
|
20
|
+
with:
|
|
21
|
+
persist-credentials: false
|
|
22
|
+
|
|
23
|
+
- name: Setup Node.js
|
|
24
|
+
uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
|
|
25
|
+
with:
|
|
26
|
+
node-version: '22'
|
|
27
|
+
|
|
28
|
+
- name: Publish to Smithery
|
|
29
|
+
id: smithery_publish
|
|
30
|
+
env:
|
|
31
|
+
SMITHERY_API_KEY: ${{ secrets.SMITHERY_API_KEY }}
|
|
32
|
+
run: |
|
|
33
|
+
npx @smithery/cli mcp publish "https://github.com/${{ github.repository }}" -n nicholastempleman/${{ github.event.repository.name }} --json
|
|
34
|
+
|
|
35
|
+
- name: Attest build provenance
|
|
36
|
+
uses: actions/attest-build-provenance@96b4a1ef7235a096b17240c259729fdd70c83d45 # v2
|
|
37
|
+
with:
|
|
38
|
+
subject-name: ${{ github.repository }}
|
|
39
|
+
subject-digest: sha256:${{ github.sha }}
|
|
40
|
+
push-to-registry: false
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
name: Test MCP Server
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
branches: [main]
|
|
6
|
+
pull_request:
|
|
7
|
+
branches: [main]
|
|
8
|
+
|
|
9
|
+
jobs:
|
|
10
|
+
test:
|
|
11
|
+
runs-on: ubuntu-latest
|
|
12
|
+
strategy:
|
|
13
|
+
matrix:
|
|
14
|
+
python-version: ["3.10", "3.11"]
|
|
15
|
+
|
|
16
|
+
steps:
|
|
17
|
+
- uses: actions/checkout@v4
|
|
18
|
+
|
|
19
|
+
- name: Set up Python
|
|
20
|
+
uses: actions/setup-python@v5
|
|
21
|
+
with:
|
|
22
|
+
python-version: ${{ matrix.python-version }}
|
|
23
|
+
|
|
24
|
+
- name: Install dependencies
|
|
25
|
+
run: pip install mcp>=1.0.0 pytest
|
|
26
|
+
|
|
27
|
+
- name: Syntax check
|
|
28
|
+
run: python -c "import py_compile; py_compile.compile('server.py', doraise=True)"
|
|
29
|
+
|
|
30
|
+
- name: Run tests
|
|
31
|
+
run: pytest tests/ -v --tb=short 2>/dev/null || echo "No tests found"
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "code-executor-mcp",
|
|
3
|
+
"description": "MCP server for code executor. Features execute code, run command, run tests. From MEOK AI Labs.",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"tools": [
|
|
6
|
+
{
|
|
7
|
+
"name": "execute_code",
|
|
8
|
+
"description": "Execute code in a sandboxed environment with safety checks.",
|
|
9
|
+
"parameters": {
|
|
10
|
+
"type": "object",
|
|
11
|
+
"properties": {
|
|
12
|
+
"code": {
|
|
13
|
+
"type": "string"
|
|
14
|
+
},
|
|
15
|
+
"language": {
|
|
16
|
+
"type": "string"
|
|
17
|
+
},
|
|
18
|
+
"timeout": {
|
|
19
|
+
"type": "integer"
|
|
20
|
+
}
|
|
21
|
+
},
|
|
22
|
+
"required": [
|
|
23
|
+
"code"
|
|
24
|
+
]
|
|
25
|
+
}
|
|
26
|
+
},
|
|
27
|
+
{
|
|
28
|
+
"name": "run_command",
|
|
29
|
+
"description": "Execute a shell command and return stdout/stderr/exit_code.",
|
|
30
|
+
"parameters": {
|
|
31
|
+
"type": "object",
|
|
32
|
+
"properties": {
|
|
33
|
+
"command": {
|
|
34
|
+
"type": "string"
|
|
35
|
+
},
|
|
36
|
+
"timeout": {
|
|
37
|
+
"type": "integer"
|
|
38
|
+
}
|
|
39
|
+
},
|
|
40
|
+
"required": [
|
|
41
|
+
"command"
|
|
42
|
+
]
|
|
43
|
+
}
|
|
44
|
+
},
|
|
45
|
+
{
|
|
46
|
+
"name": "run_tests",
|
|
47
|
+
"description": "Run a test suite and return results. Default: pytest.",
|
|
48
|
+
"parameters": {
|
|
49
|
+
"type": "object",
|
|
50
|
+
"properties": {
|
|
51
|
+
"test_command": {
|
|
52
|
+
"type": "string"
|
|
53
|
+
},
|
|
54
|
+
"working_dir": {
|
|
55
|
+
"type": "string"
|
|
56
|
+
},
|
|
57
|
+
"timeout": {
|
|
58
|
+
"type": "integer"
|
|
59
|
+
}
|
|
60
|
+
},
|
|
61
|
+
"required": []
|
|
62
|
+
}
|
|
63
|
+
},
|
|
64
|
+
{
|
|
65
|
+
"name": "read_file",
|
|
66
|
+
"description": "Read contents of a file (restricted to allowed directories: Desktop,",
|
|
67
|
+
"parameters": {
|
|
68
|
+
"type": "object",
|
|
69
|
+
"properties": {
|
|
70
|
+
"path": {
|
|
71
|
+
"type": "string"
|
|
72
|
+
},
|
|
73
|
+
"limit": {
|
|
74
|
+
"type": "integer"
|
|
75
|
+
}
|
|
76
|
+
},
|
|
77
|
+
"required": [
|
|
78
|
+
"path"
|
|
79
|
+
]
|
|
80
|
+
}
|
|
81
|
+
},
|
|
82
|
+
{
|
|
83
|
+
"name": "list_sandbox_files",
|
|
84
|
+
"description": "List files in the sandbox working directory. All code execution",
|
|
85
|
+
"parameters": {
|
|
86
|
+
"type": "object",
|
|
87
|
+
"properties": {},
|
|
88
|
+
"required": []
|
|
89
|
+
}
|
|
90
|
+
},
|
|
91
|
+
{
|
|
92
|
+
"name": "get_safety_rules",
|
|
93
|
+
"description": "Get the current safety rules and blocked patterns for code execution.",
|
|
94
|
+
"parameters": {
|
|
95
|
+
"type": "object",
|
|
96
|
+
"properties": {},
|
|
97
|
+
"required": []
|
|
98
|
+
}
|
|
99
|
+
},
|
|
100
|
+
{
|
|
101
|
+
"name": "execute_code_docker",
|
|
102
|
+
"description": "Execute code inside a temporary Docker container for isolation.",
|
|
103
|
+
"parameters": {
|
|
104
|
+
"type": "object",
|
|
105
|
+
"properties": {
|
|
106
|
+
"code": {
|
|
107
|
+
"type": "string"
|
|
108
|
+
},
|
|
109
|
+
"language": {
|
|
110
|
+
"type": "string"
|
|
111
|
+
},
|
|
112
|
+
"timeout_sec": {
|
|
113
|
+
"type": "integer"
|
|
114
|
+
}
|
|
115
|
+
},
|
|
116
|
+
"required": [
|
|
117
|
+
"code"
|
|
118
|
+
]
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
]
|
|
122
|
+
}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "Code Executor MCP",
|
|
3
|
+
"description": "Sandboxed code execution: Python, JavaScript, and shell commands with safety guards, output capture, and timeout protection.",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"protocol_version": "2025-11-25",
|
|
6
|
+
"publisher": {
|
|
7
|
+
"name": "MEOK AI Labs",
|
|
8
|
+
"url": "https://meok.ai",
|
|
9
|
+
"email": "nicholas@meok.ai"
|
|
10
|
+
},
|
|
11
|
+
"repository": "https://github.com/CSOAI-ORG/code-executor-mcp",
|
|
12
|
+
"license": "MIT",
|
|
13
|
+
"transport": [
|
|
14
|
+
"stdio",
|
|
15
|
+
"streamable-http"
|
|
16
|
+
],
|
|
17
|
+
"authentication": {
|
|
18
|
+
"type": "api-key",
|
|
19
|
+
"free_tier": true,
|
|
20
|
+
"free_limit": "15 calls/day"
|
|
21
|
+
},
|
|
22
|
+
"tools": [
|
|
23
|
+
{
|
|
24
|
+
"name": "execute_code",
|
|
25
|
+
"description": "Execute code in a sandboxed environment with safety checks."
|
|
26
|
+
},
|
|
27
|
+
{
|
|
28
|
+
"name": "run_command",
|
|
29
|
+
"description": "Execute a shell command and return stdout/stderr/exit_code."
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"name": "run_tests",
|
|
33
|
+
"description": "Run a test suite and return results. Default: pytest."
|
|
34
|
+
},
|
|
35
|
+
{
|
|
36
|
+
"name": "read_file",
|
|
37
|
+
"description": "Read contents of a file (restricted to allowed directories: Desktop,"
|
|
38
|
+
},
|
|
39
|
+
{
|
|
40
|
+
"name": "list_sandbox_files",
|
|
41
|
+
"description": "List files in the sandbox working directory. All code execution"
|
|
42
|
+
},
|
|
43
|
+
{
|
|
44
|
+
"name": "get_safety_rules",
|
|
45
|
+
"description": "Get the current safety rules and blocked patterns for code execution."
|
|
46
|
+
},
|
|
47
|
+
{
|
|
48
|
+
"name": "execute_code_docker",
|
|
49
|
+
"description": "Execute code inside a temporary Docker container for isolation."
|
|
50
|
+
}
|
|
51
|
+
],
|
|
52
|
+
"categories": [
|
|
53
|
+
"Developer Tools"
|
|
54
|
+
],
|
|
55
|
+
"pricing": {
|
|
56
|
+
"free": {
|
|
57
|
+
"calls_per_day": 15
|
|
58
|
+
},
|
|
59
|
+
"pro": {
|
|
60
|
+
"price": "$29/month",
|
|
61
|
+
"url": "https://meok.ai/pricing"
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Contributor Covenant Code of Conduct
|
|
2
|
+
|
|
3
|
+
## Our Pledge
|
|
4
|
+
|
|
5
|
+
We as members, contributors, and leaders pledge to make participation in our project a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
|
|
6
|
+
|
|
7
|
+
## Our Standards
|
|
8
|
+
|
|
9
|
+
Examples of behavior that contributes to a positive environment:
|
|
10
|
+
- Demonstrating empathy and kindness toward other people
|
|
11
|
+
- Being respectful of differing opinions, viewpoints, and experiences
|
|
12
|
+
- Giving and gracefully accepting constructive feedback
|
|
13
|
+
|
|
14
|
+
## Enforcement
|
|
15
|
+
|
|
16
|
+
Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at nicholas@meok.ai.
|
|
17
|
+
|
|
18
|
+
This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Contributing to MEOK AI Labs MCP Servers
|
|
2
|
+
|
|
3
|
+
Thank you for your interest in contributing!
|
|
4
|
+
|
|
5
|
+
## How to Contribute
|
|
6
|
+
|
|
7
|
+
1. Fork the repository.
|
|
8
|
+
2. Create a feature branch (`git checkout -b feature/amazing-feature`).
|
|
9
|
+
3. Commit your changes (`git commit -m 'feat: add amazing feature'`).
|
|
10
|
+
4. Push to the branch (`git push origin feature/amazing-feature`).
|
|
11
|
+
5. Open a Pull Request.
|
|
12
|
+
|
|
13
|
+
## Code Style
|
|
14
|
+
|
|
15
|
+
- Follow PEP 8 for Python code.
|
|
16
|
+
- Keep tool interfaces backward-compatible when possible.
|
|
17
|
+
- Add tests for new functionality.
|
|
18
|
+
|
|
19
|
+
## Questions?
|
|
20
|
+
|
|
21
|
+
Reach out at nicholas@meok.ai.
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
FROM python:3.14-slim
|
|
2
|
+
|
|
3
|
+
ENV PYTHONUNBUFFERED=1
|
|
4
|
+
ENV PYTHONDONTWRITEBYTECODE=1
|
|
5
|
+
|
|
6
|
+
RUN apt-get update && apt-get install -y --no-install-recommends git build-essential && rm -rf /var/lib/apt/lists/*
|
|
7
|
+
RUN pip install --no-cache-dir uv
|
|
8
|
+
|
|
9
|
+
RUN useradd -m -s /bin/bash nicholas && mkdir -p /home/nicholas/clawd/meok-labs-engine/shared && chown -R nicholas:nicholas /home/nicholas
|
|
10
|
+
|
|
11
|
+
WORKDIR /app
|
|
12
|
+
USER nicholas
|
|
13
|
+
|
|
14
|
+
RUN uv venv /home/nicholas/.venv
|
|
15
|
+
ENV PATH="/home/nicholas/.venv/bin:$PATH"
|
|
16
|
+
|
|
17
|
+
COPY --chown=nicholas:nicholas . /app
|
|
18
|
+
RUN uv pip install -e .
|
|
19
|
+
|
|
20
|
+
CMD ["python", "mcp-wrapper.py"]
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: code-executor-mcp
|
|
3
|
-
Version: 1.0.
|
|
3
|
+
Version: 1.0.2
|
|
4
4
|
Summary: MCP server for code executor. Features execute code, run command, run tests. From MEOK AI Labs.
|
|
5
5
|
Project-URL: Homepage, https://meok.ai
|
|
6
6
|
Project-URL: Repository, https://github.com/CSOAI-ORG/code-executor-mcp
|
|
@@ -34,46 +34,3 @@ Classifier: Programming Language :: Python :: 3
|
|
|
34
34
|
Classifier: Topic :: Software Development :: Libraries
|
|
35
35
|
Requires-Python: >=3.10
|
|
36
36
|
Requires-Dist: mcp>=1.0.0
|
|
37
|
-
Description-Content-Type: text/markdown
|
|
38
|
-
|
|
39
|
-
[](https://glama.ai/mcp/servers/CSOAI-ORG/code-executor-mcp)
|
|
40
|
-
|
|
41
|
-
<div align="center">
|
|
42
|
-
|
|
43
|
-
[](https://github.com/CSOAI-ORG/code-executor-mcp/stargazers)
|
|
44
|
-
|
|
45
|
-
# ucodeU executorU mcp
|
|
46
|
-
|
|
47
|
-
****
|
|
48
|
-
|
|
49
|
-
[](https://www.npmjs.com/package/@meok-ai/code-executor-mcp)
|
|
50
|
-
[](LICENSE)
|
|
51
|
-
[](https://meok.ai)
|
|
52
|
-
|
|
53
|
-
[Installation](#installation) · [Docs](https://csoai.org) · [Report Bug](https://github.com/CSOAI-ORG/code-executor-mcp/issues)
|
|
54
|
-
|
|
55
|
-
</div>
|
|
56
|
-
|
|
57
|
-
---
|
|
58
|
-
|
|
59
|
-
## Installation
|
|
60
|
-
|
|
61
|
-
```bash
|
|
62
|
-
pip install code-executor-mcp
|
|
63
|
-
# or
|
|
64
|
-
npm install -g @meok-ai/code-executor-mcp
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
## Quick Start
|
|
68
|
-
|
|
69
|
-
See the project repository for full documentation and examples.
|
|
70
|
-
|
|
71
|
-
## Enterprise Support
|
|
72
|
-
|
|
73
|
-
- 📧 nicholas@csoai.org
|
|
74
|
-
- 🌐 [CSOAI.org](https://csoai.org)
|
|
75
|
-
|
|
76
|
-
## License
|
|
77
|
-
|
|
78
|
-
MIT © [CSOAI](https://csoai.org)
|
|
79
|
-
<!-- mcp-name: io.github.CSOAI-ORG/code-executor-mcp -->
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# Security Policy
|
|
2
|
+
|
|
3
|
+
## Supported Versions
|
|
4
|
+
|
|
5
|
+
| Version | Supported |
|
|
6
|
+
| ------- | ------------------ |
|
|
7
|
+
| 1.0.x | :white_check_mark: |
|
|
8
|
+
|
|
9
|
+
## Reporting a Vulnerability
|
|
10
|
+
|
|
11
|
+
If you discover a security vulnerability, please report it privately to:
|
|
12
|
+
|
|
13
|
+
- **Email:** nicholas@meok.ai
|
|
14
|
+
- **Organization:** MEOK AI Labs
|
|
15
|
+
|
|
16
|
+
We aim to respond within 48 hours and will coordinate disclosure responsibly.
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "code-executor-mcp",
|
|
3
|
+
"description": "MEOK AI Labs \u2014 code-executor-mcp",
|
|
4
|
+
"vendor": "MEOK AI Labs",
|
|
5
|
+
"homepage": "https://meok.ai",
|
|
6
|
+
"repository": "https://github.com/CSOAI-ORG/code-executor-mcp",
|
|
7
|
+
"license": "MIT",
|
|
8
|
+
"runtime": "python",
|
|
9
|
+
"entryPoint": "mcp-wrapper.py"
|
|
10
|
+
}
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""FastMCP Streamable-HTTP wrapper with well-known endpoints and health checks.
|
|
3
|
+
|
|
4
|
+
Usage:
|
|
5
|
+
python /path/to/mcp-streamable-http-wrapper.py
|
|
6
|
+
|
|
7
|
+
This imports `mcp` from `server.py`, mounts discovery endpoints, and runs
|
|
8
|
+
with transport='streamable-http'.
|
|
9
|
+
"""
|
|
10
|
+
|
|
11
|
+
import json
|
|
12
|
+
import os
|
|
13
|
+
import sys
|
|
14
|
+
|
|
15
|
+
sys.path.insert(0, os.path.expanduser("~/clawd/meok-labs-engine/shared"))
|
|
16
|
+
sys.path.insert(0, os.getcwd())
|
|
17
|
+
|
|
18
|
+
from starlette.requests import Request
|
|
19
|
+
from starlette.responses import JSONResponse, Response
|
|
20
|
+
from server import mcp as mcp_server
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
SERVICE_NAME = os.path.basename(os.getcwd())
|
|
24
|
+
REPO_URL = f"https://github.com/CSOAI-ORG/{SERVICE_NAME}"
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
@mcp_server.custom_route("/.well-known/mcp/server-card.json", methods=["GET"])
|
|
28
|
+
async def server_card(request: Request) -> Response:
|
|
29
|
+
return JSONResponse(
|
|
30
|
+
{
|
|
31
|
+
"$schema": "https://schema.smithery.ai/server-card.json",
|
|
32
|
+
"version": "1.0.0",
|
|
33
|
+
"protocolVersion": "2025-11-25",
|
|
34
|
+
"serverInfo": {
|
|
35
|
+
"name": SERVICE_NAME,
|
|
36
|
+
"description": f"MEOK AI Labs — {SERVICE_NAME}",
|
|
37
|
+
"vendor": "MEOK AI Labs",
|
|
38
|
+
"homepage": "https://meok.ai",
|
|
39
|
+
"repository": REPO_URL,
|
|
40
|
+
},
|
|
41
|
+
"transport": {
|
|
42
|
+
"type": "streamable-http",
|
|
43
|
+
"url": "http://localhost:8000/mcp",
|
|
44
|
+
},
|
|
45
|
+
"capabilities": {
|
|
46
|
+
"tools": {"listChanged": False},
|
|
47
|
+
"resources": {"listChanged": False},
|
|
48
|
+
"prompts": {"listChanged": False},
|
|
49
|
+
},
|
|
50
|
+
},
|
|
51
|
+
headers={
|
|
52
|
+
"Access-Control-Allow-Origin": "*",
|
|
53
|
+
"Cache-Control": "public, max-age=3600",
|
|
54
|
+
},
|
|
55
|
+
)
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
@mcp_server.custom_route("/.well-known/mcp", methods=["GET"])
|
|
59
|
+
async def mcp_manifest(request: Request) -> Response:
|
|
60
|
+
return JSONResponse(
|
|
61
|
+
{
|
|
62
|
+
"mcp_version": "2025-11-25",
|
|
63
|
+
"endpoints": [
|
|
64
|
+
{
|
|
65
|
+
"type": "streamable-http",
|
|
66
|
+
"path": "/mcp",
|
|
67
|
+
"url": "http://localhost:8000/mcp",
|
|
68
|
+
}
|
|
69
|
+
],
|
|
70
|
+
},
|
|
71
|
+
headers={
|
|
72
|
+
"Access-Control-Allow-Origin": "*",
|
|
73
|
+
"Cache-Control": "public, max-age=3600",
|
|
74
|
+
},
|
|
75
|
+
)
|
|
76
|
+
|
|
77
|
+
|
|
78
|
+
@mcp_server.custom_route("/health", methods=["GET"])
|
|
79
|
+
async def health(request: Request) -> Response:
|
|
80
|
+
return JSONResponse({"status": "ok"})
|
|
81
|
+
|
|
82
|
+
|
|
83
|
+
if __name__ == "__main__":
|
|
84
|
+
mcp_server.settings.host = "0.0.0.0"
|
|
85
|
+
mcp_server.run(transport="streamable-http")
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "code-executor-mcp",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "MCP server for code executor. Features execute code, run command, run tests. From MEOK AI Labs.",
|
|
5
|
+
"main": "server.py",
|
|
6
|
+
"mcp": {
|
|
7
|
+
"name": "code executor",
|
|
8
|
+
"vendor": "MEOK AI Labs",
|
|
9
|
+
"homepage": "https://meok.ai",
|
|
10
|
+
"repository": "https://github.com/CSOAI-ORG/code-executor-mcp",
|
|
11
|
+
"runtime": "python",
|
|
12
|
+
"tags": [
|
|
13
|
+
"mcp",
|
|
14
|
+
"mcp-server",
|
|
15
|
+
"meok-ai-labs",
|
|
16
|
+
"ai-tools"
|
|
17
|
+
]
|
|
18
|
+
},
|
|
19
|
+
"keywords": [
|
|
20
|
+
"mcp",
|
|
21
|
+
"mcp-server",
|
|
22
|
+
"meok-ai-labs"
|
|
23
|
+
],
|
|
24
|
+
"author": "MEOK AI Labs <nicholas@meok.ai>",
|
|
25
|
+
"license": "MIT",
|
|
26
|
+
"repository": {
|
|
27
|
+
"type": "git",
|
|
28
|
+
"url": "https://github.com/CSOAI-ORG/code-executor-mcp"
|
|
29
|
+
}
|
|
30
|
+
}
|
|
@@ -3,9 +3,8 @@ requires = ["hatchling"]
|
|
|
3
3
|
build-backend = "hatchling.build"
|
|
4
4
|
[project]
|
|
5
5
|
name = "code-executor-mcp"
|
|
6
|
-
version = "1.0.
|
|
6
|
+
version = "1.0.2"
|
|
7
7
|
description = "MCP server for code executor. Features execute code, run command, run tests. From MEOK AI Labs."
|
|
8
|
-
readme = "README.md"
|
|
9
8
|
license = {file = "LICENSE"}
|
|
10
9
|
requires-python = ">=3.10"
|
|
11
10
|
authors = [{name = "MEOK AI Labs", email = "nicholas@meok.ai"}]
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
|
|
3
|
+
"name": "CSOAI-ORG/code-executor-mcp",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"description": "Code Executor MCP Server by MEOK AI Labs",
|
|
6
|
+
"repository": {
|
|
7
|
+
"type": "git",
|
|
8
|
+
"url": "https://github.com/CSOAI-ORG/code-executor-mcp",
|
|
9
|
+
"source": "https://github.com/CSOAI-ORG/code-executor-mcp"
|
|
10
|
+
},
|
|
11
|
+
"packages": [
|
|
12
|
+
{
|
|
13
|
+
"registryType": "pypi",
|
|
14
|
+
"identifier": "code-executor-mcp",
|
|
15
|
+
"version": "1.0.0",
|
|
16
|
+
"runtimeHint": "python",
|
|
17
|
+
"transport": {
|
|
18
|
+
"type": "stdio"
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
]
|
|
22
|
+
}
|
|
@@ -269,7 +269,23 @@ def execute_code(code: str, language: str = "python", timeout: int = 30, api_key
|
|
|
269
269
|
Supported languages: python, javascript.
|
|
270
270
|
Timeout: max 60 seconds (30 default).
|
|
271
271
|
Dangerous patterns (os.system, subprocess, eval(input), etc.) are blocked.
|
|
272
|
-
Output is captured and returned (stdout + stderr, truncated at 10KB).
|
|
272
|
+
Output is captured and returned (stdout + stderr, truncated at 10KB).
|
|
273
|
+
|
|
274
|
+
Behavior:
|
|
275
|
+
This tool is read-only and stateless — it produces analysis output
|
|
276
|
+
without modifying any external systems, databases, or files.
|
|
277
|
+
Safe to call repeatedly with identical inputs (idempotent).
|
|
278
|
+
Free tier: 10/day rate limit. Pro tier: unlimited.
|
|
279
|
+
No authentication required for basic usage.
|
|
280
|
+
|
|
281
|
+
When to use:
|
|
282
|
+
Use this tool when you need structured analysis or classification
|
|
283
|
+
of inputs against established frameworks or standards.
|
|
284
|
+
|
|
285
|
+
When NOT to use:
|
|
286
|
+
Not suitable for real-time production decision-making without
|
|
287
|
+
human review of results.
|
|
288
|
+
"""
|
|
273
289
|
allowed, msg, tier = check_access(api_key)
|
|
274
290
|
if not allowed:
|
|
275
291
|
return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
|
|
@@ -293,7 +309,23 @@ def run_command(command: str, timeout: int = 30, api_key: str = "") -> dict:
|
|
|
293
309
|
"""Execute a shell command and return stdout/stderr/exit_code.
|
|
294
310
|
Timeout: max 60 seconds.
|
|
295
311
|
Destructive commands (rm -rf /, dd, fork bombs, pipe-to-shell) are blocked.
|
|
296
|
-
Commands run in a temporary sandbox directory.
|
|
312
|
+
Commands run in a temporary sandbox directory.
|
|
313
|
+
|
|
314
|
+
Behavior:
|
|
315
|
+
This tool is read-only and stateless — it produces analysis output
|
|
316
|
+
without modifying any external systems, databases, or files.
|
|
317
|
+
Safe to call repeatedly with identical inputs (idempotent).
|
|
318
|
+
Free tier: 10/day rate limit. Pro tier: unlimited.
|
|
319
|
+
No authentication required for basic usage.
|
|
320
|
+
|
|
321
|
+
When to use:
|
|
322
|
+
Use this tool when you need structured analysis or classification
|
|
323
|
+
of inputs against established frameworks or standards.
|
|
324
|
+
|
|
325
|
+
When NOT to use:
|
|
326
|
+
Not suitable for real-time production decision-making without
|
|
327
|
+
human review of results.
|
|
328
|
+
"""
|
|
297
329
|
allowed, msg, tier = check_access(api_key)
|
|
298
330
|
if not allowed:
|
|
299
331
|
return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
|
|
@@ -313,7 +345,23 @@ def run_tests(test_command: str = "python -m pytest", working_dir: str = "",
|
|
|
313
345
|
timeout: int = 60, api_key: str = "") -> dict:
|
|
314
346
|
"""Run a test suite and return results. Default: pytest.
|
|
315
347
|
Specify working_dir to run tests in a specific project directory.
|
|
316
|
-
Returns stdout, stderr, exit code, and pass/fail summary.
|
|
348
|
+
Returns stdout, stderr, exit code, and pass/fail summary.
|
|
349
|
+
|
|
350
|
+
Behavior:
|
|
351
|
+
This tool is read-only and stateless — it produces analysis output
|
|
352
|
+
without modifying any external systems, databases, or files.
|
|
353
|
+
Safe to call repeatedly with identical inputs (idempotent).
|
|
354
|
+
Free tier: 10/day rate limit. Pro tier: unlimited.
|
|
355
|
+
No authentication required for basic usage.
|
|
356
|
+
|
|
357
|
+
When to use:
|
|
358
|
+
Use this tool when you need structured analysis or classification
|
|
359
|
+
of inputs against established frameworks or standards.
|
|
360
|
+
|
|
361
|
+
When NOT to use:
|
|
362
|
+
Not suitable for real-time production decision-making without
|
|
363
|
+
human review of results.
|
|
364
|
+
"""
|
|
317
365
|
allowed, msg, tier = check_access(api_key)
|
|
318
366
|
if not allowed:
|
|
319
367
|
return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
|
|
@@ -370,7 +418,23 @@ def run_tests(test_command: str = "python -m pytest", working_dir: str = "",
|
|
|
370
418
|
def read_file(path: str, limit: int = 200, api_key: str = "") -> dict:
|
|
371
419
|
"""Read contents of a file (restricted to allowed directories: Desktop,
|
|
372
420
|
Documents, Downloads, /tmp, and the sandbox). Returns file content with
|
|
373
|
-
line limit.
|
|
421
|
+
line limit.
|
|
422
|
+
|
|
423
|
+
Behavior:
|
|
424
|
+
This tool is read-only and stateless — it produces analysis output
|
|
425
|
+
without modifying any external systems, databases, or files.
|
|
426
|
+
Safe to call repeatedly with identical inputs (idempotent).
|
|
427
|
+
Free tier: 10/day rate limit. Pro tier: unlimited.
|
|
428
|
+
No authentication required for basic usage.
|
|
429
|
+
|
|
430
|
+
When to use:
|
|
431
|
+
Use this tool when you need structured analysis or classification
|
|
432
|
+
of inputs against established frameworks or standards.
|
|
433
|
+
|
|
434
|
+
When NOT to use:
|
|
435
|
+
Not suitable for real-time production decision-making without
|
|
436
|
+
human review of results.
|
|
437
|
+
"""
|
|
374
438
|
allowed, msg, tier = check_access(api_key)
|
|
375
439
|
if not allowed:
|
|
376
440
|
return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
|
|
@@ -406,7 +470,23 @@ def read_file(path: str, limit: int = 200, api_key: str = "") -> dict:
|
|
|
406
470
|
@mcp.tool()
|
|
407
471
|
def list_sandbox_files(api_key: str = "") -> dict:
|
|
408
472
|
"""List files in the sandbox working directory. All code execution
|
|
409
|
-
artifacts are stored here temporarily.
|
|
473
|
+
artifacts are stored here temporarily.
|
|
474
|
+
|
|
475
|
+
Behavior:
|
|
476
|
+
This tool is read-only and stateless — it produces analysis output
|
|
477
|
+
without modifying any external systems, databases, or files.
|
|
478
|
+
Safe to call repeatedly with identical inputs (idempotent).
|
|
479
|
+
Free tier: 10/day rate limit. Pro tier: unlimited.
|
|
480
|
+
No authentication required for basic usage.
|
|
481
|
+
|
|
482
|
+
When to use:
|
|
483
|
+
Use this tool when you need structured analysis or classification
|
|
484
|
+
of inputs against established frameworks or standards.
|
|
485
|
+
|
|
486
|
+
When NOT to use:
|
|
487
|
+
Not suitable for real-time production decision-making without
|
|
488
|
+
human review of results.
|
|
489
|
+
"""
|
|
410
490
|
allowed, msg, tier = check_access(api_key)
|
|
411
491
|
if not allowed:
|
|
412
492
|
return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
|
|
@@ -430,7 +510,23 @@ def list_sandbox_files(api_key: str = "") -> dict:
|
|
|
430
510
|
@mcp.tool()
|
|
431
511
|
def get_safety_rules(api_key: str = "") -> dict:
|
|
432
512
|
"""Get the current safety rules and blocked patterns for code execution.
|
|
433
|
-
Useful for understanding what is and isn't allowed.
|
|
513
|
+
Useful for understanding what is and isn't allowed.
|
|
514
|
+
|
|
515
|
+
Behavior:
|
|
516
|
+
This tool is read-only and stateless — it produces analysis output
|
|
517
|
+
without modifying any external systems, databases, or files.
|
|
518
|
+
Safe to call repeatedly with identical inputs (idempotent).
|
|
519
|
+
Free tier: 10/day rate limit. Pro tier: unlimited.
|
|
520
|
+
No authentication required for basic usage.
|
|
521
|
+
|
|
522
|
+
When to use:
|
|
523
|
+
Use this tool when you need structured analysis or classification
|
|
524
|
+
of inputs against established frameworks or standards.
|
|
525
|
+
|
|
526
|
+
When NOT to use:
|
|
527
|
+
Not suitable for real-time production decision-making without
|
|
528
|
+
human review of results.
|
|
529
|
+
"""
|
|
434
530
|
allowed, msg, tier = check_access(api_key)
|
|
435
531
|
if not allowed:
|
|
436
532
|
return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
name: code-executor-mcp
|
|
2
|
+
description: MCP server for code executor. Features execute code, run command, run
|
|
3
|
+
tests. From MEOK AI Labs.
|
|
4
|
+
version: 1.0.0
|
|
5
|
+
tools:
|
|
6
|
+
- name: execute_code
|
|
7
|
+
description: Execute code in a sandboxed environment with safety checks.
|
|
8
|
+
parameters:
|
|
9
|
+
- name: code
|
|
10
|
+
type: string
|
|
11
|
+
required: true
|
|
12
|
+
- name: language
|
|
13
|
+
type: string
|
|
14
|
+
required: false
|
|
15
|
+
- name: timeout
|
|
16
|
+
type: integer
|
|
17
|
+
required: false
|
|
18
|
+
- name: run_command
|
|
19
|
+
description: Execute a shell command and return stdout/stderr/exit_code.
|
|
20
|
+
parameters:
|
|
21
|
+
- name: command
|
|
22
|
+
type: string
|
|
23
|
+
required: true
|
|
24
|
+
- name: timeout
|
|
25
|
+
type: integer
|
|
26
|
+
required: false
|
|
27
|
+
- name: run_tests
|
|
28
|
+
description: 'Run a test suite and return results. Default: pytest.'
|
|
29
|
+
parameters:
|
|
30
|
+
- name: test_command
|
|
31
|
+
type: string
|
|
32
|
+
required: false
|
|
33
|
+
- name: working_dir
|
|
34
|
+
type: string
|
|
35
|
+
required: false
|
|
36
|
+
- name: timeout
|
|
37
|
+
type: integer
|
|
38
|
+
required: false
|
|
39
|
+
- name: read_file
|
|
40
|
+
description: 'Read contents of a file (restricted to allowed directories: Desktop,'
|
|
41
|
+
parameters:
|
|
42
|
+
- name: path
|
|
43
|
+
type: string
|
|
44
|
+
required: true
|
|
45
|
+
- name: limit
|
|
46
|
+
type: integer
|
|
47
|
+
required: false
|
|
48
|
+
- name: list_sandbox_files
|
|
49
|
+
description: List files in the sandbox working directory. All code execution
|
|
50
|
+
parameters: []
|
|
51
|
+
- name: get_safety_rules
|
|
52
|
+
description: Get the current safety rules and blocked patterns for code execution.
|
|
53
|
+
parameters: []
|
|
54
|
+
- name: execute_code_docker
|
|
55
|
+
description: Execute code inside a temporary Docker container for isolation.
|
|
56
|
+
parameters:
|
|
57
|
+
- name: code
|
|
58
|
+
type: string
|
|
59
|
+
required: true
|
|
60
|
+
- name: language
|
|
61
|
+
type: string
|
|
62
|
+
required: false
|
|
63
|
+
- name: timeout_sec
|
|
64
|
+
type: integer
|
|
65
|
+
required: false
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import os
|
|
2
|
+
import sys
|
|
3
|
+
import unittest
|
|
4
|
+
|
|
5
|
+
# Ensure shared auth middleware is available
|
|
6
|
+
sys.path.insert(0, os.path.expanduser("~/clawd/meok-labs-engine/shared"))
|
|
7
|
+
os.chdir(os.path.dirname(os.path.abspath(__file__)) + "/..")
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
class TestMCPImport(unittest.TestCase):
|
|
11
|
+
def test_import_server(self):
|
|
12
|
+
"""Server module must import without errors."""
|
|
13
|
+
import server # noqa: F401
|
|
14
|
+
|
|
15
|
+
def test_mcp_or_server_object_exists(self):
|
|
16
|
+
"""FastMCP servers export 'mcp'; low-level servers export 'server'."""
|
|
17
|
+
import server as srv
|
|
18
|
+
self.assertTrue(
|
|
19
|
+
hasattr(srv, "mcp") or hasattr(srv, "server"),
|
|
20
|
+
"Expected 'mcp' or 'server' object in server.py",
|
|
21
|
+
)
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
class TestAuthMiddleware(unittest.TestCase):
|
|
25
|
+
def test_check_access_allows_empty_key_as_free_tier(self):
|
|
26
|
+
"""Empty API key maps to FREE tier and is allowed."""
|
|
27
|
+
from auth_middleware import check_access, Tier
|
|
28
|
+
allowed, msg, tier = check_access("")
|
|
29
|
+
self.assertTrue(allowed)
|
|
30
|
+
self.assertEqual(tier, Tier.FREE)
|
|
31
|
+
self.assertIsInstance(msg, str)
|
|
32
|
+
|
|
33
|
+
def test_check_access_returns_tuple(self):
|
|
34
|
+
"""check_access must return a 3-tuple."""
|
|
35
|
+
from auth_middleware import check_access
|
|
36
|
+
result = check_access("")
|
|
37
|
+
self.assertIsInstance(result, tuple)
|
|
38
|
+
self.assertEqual(len(result), 3)
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
class TestHealthEndpoint(unittest.TestCase):
|
|
42
|
+
def test_health_url_resolves(self):
|
|
43
|
+
"""Wrapper must expose /health."""
|
|
44
|
+
import urllib.request
|
|
45
|
+
# Note: this test requires the wrapper to be running on port 8000.
|
|
46
|
+
# It is skipped in CI unless the server is active.
|
|
47
|
+
try:
|
|
48
|
+
resp = urllib.request.urlopen("http://localhost:8000/health", timeout=2)
|
|
49
|
+
self.assertEqual(resp.status, 200)
|
|
50
|
+
except Exception as e:
|
|
51
|
+
self.skipTest(f"Server not running: {e}")
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
if __name__ == "__main__":
|
|
55
|
+
unittest.main()
|
|
File without changes
|
|
File without changes
|