MCP Run Python Code

🚀 mcp-run-python-code

このプロジェクトはPythonインタープリターとMCPサーバーを提供し、APIキー不要で無料です。Pythonコードを実行して結果を取得できます。

🚀 クイックスタート

このMCPサーバーは、Pythonコードの実行、パッケージのインストール、Pythonファイルの実行などのツールを提供します。Claudeやその他のMCPプロトコルをサポートするLLMアプリケーションなどのMCPクライアントと簡単に統合できます。

✨ 主な機能

• 安全な環境でPythonコードを実行する
• pipを使用してPythonパッケージをインストールする
• Pythonコードをファイルに保存して実行する
• 既存のPythonファイルを実行する
• 実行したコードから特定の変数値を返す
• エラーハンドリングとデバッグをサポートする

📦 インストール

pipからのインストール

uvを使用してMCP Run Python Code Serverをインストールできます。

uv pip install mcp-run-python-code

または、pipを使用してインストールすることもできます。

pip install mcp-run-python-code

ソースからのインストール

git clone https://github.com/shibing624/mcp-run-python-code.git
cd mcp-run-python-code
pip install -e .

💻 使用例

基本的な使用法

from run_python_code import RunPythonCode

tool = RunPythonCode(base_dir='/tmp/tmp_run_code/')

# 示例1：基本代码执行
result = tool.run_python_code("x = 10\ny = 20\nz = x * y", "z")
print(f"结果: {result}")  # 输出: 结果: 200

# 示例2：保存并运行文件
result = tool.save_to_file_and_run(
    file_name="calc.py",
    code="a = 5\nb = 15\nc = a + b",
    variable_to_return="c"
)
print(f"结果: {result}")  # 输出: 结果: 20

# 实例3：安装python包
result = tool.pip_install_package("requests")
print(f"结果: {result}")

スタンドアロンのMCPサーバーとして実行

stdioトランスポートでサーバーを実行します。

uvx mcp-run-python-code

または

uv run mcp-run-python-code

または

python -m mcp-run-python-code

その後、stdioトランスポートをサポートする任意のMCPクライアントでサーバーを使用できます。

Cursorとの統合

CursorにこのMCPサーバーを追加するには、次のコマンドでstdio MCPを追加します。

uvx mcp-run-python-code

利用可能なツール

• run_python_code - Pythonコードを実行し、必要に応じて変数値を返す
• save_to_file_and_run - Pythonコードをファイルに保存して実行する
• pip_install_package - pipを使用してPythonパッケージをインストールする
• run_python_file - 既存のPythonファイルを実行し、必要に応じて変数値を返す

高度な使用法

例1: 基本的なコード実行

from run_python_code import RunPythonCode
tool = RunPythonCode(base_dir='/tmp/tmp_run_code/')
# Execute simple calculations
code = "result = 2 ** 10"
value = tool.run_python_code(code, "result")
print(value)  # Output: 1024

例2: Pythonファイルの実行

from run_python_code import RunPythonCode
tool = RunPythonCode(base_dir='/tmp/tmp_run_code/')
# Save code to a file and run it
script_code = """
def fibonacci(n):
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)

result = fibonacci(10)
print(f"Fibonacci(10) = {result}")
"""
result = tool.save_to_file_and_run("fib.py", script_code, "result")
print(result)  # Output: 55

例3: データ処理

from run_python_code import RunPythonCode
tool = RunPythonCode(base_dir='/tmp/tmp_run_code/')
# JSON data processing
code = """
import json
data = {'name': '张三', 'age': 30}
json_str = json.dumps(data, ensure_ascii=False)
"""
result = tool.run_python_code(code, "json_str")
print(result)  # Output: {"name": "张三", "age": 30}

📚 ドキュメント

連絡先

• 問題や提案:
• メール: xuming624@qq.com
• 微信: メッセージ「Name-Company-NLP」付きで私（微信ID: xuming624）を追加し、NLPディスカッショングループに参加できます。

📄 ライセンス

このプロジェクトはThe Apache License 2.0の下でライセンスされており、商用目的で自由に使用できます。ただし、あなたの製品説明にmcp-run-python-codeプロジェクトへのリンクとライセンスを含めてください。

🔧 技術詳細

貢献方法

このプロジェクトの改善に貢献することを歓迎します！プルリクエストを送信する前に、以下のことを行ってください。

1. testsディレクトリに適切なユニットテストを追加する
2. python -m pytestを実行してすべてのテストが通過することを確認する
3. 変更点を明確に記述したプルリクエストを送信する

謝辞

• MCP Python SDKを使用して構築されています。