{"id":29377934,"url":"https://github.com/ptonelli/mcp-python","last_synced_at":"2025-07-10T00:09:45.634Z","repository":{"id":300793032,"uuid":"1006928627","full_name":"ptonelli/mcp-python","owner":"ptonelli","description":"a set of mcp tools to host on your own server with a shell and python interpreter","archived":false,"fork":false,"pushed_at":"2025-07-07T20:29:20.000Z","size":36,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-07-07T23:24:40.469Z","etag":null,"topics":["git","mcp-server","python3","shell"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ptonelli.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-23T07:53:59.000Z","updated_at":"2025-07-07T20:29:23.000Z","dependencies_parsed_at":null,"dependency_job_id":"98bf2bbd-ee0a-46bd-bfee-c515b6ecfdf3","html_url":"https://github.com/ptonelli/mcp-python","commit_stats":null,"previous_names":["ptonelli/mcp-python"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ptonelli/mcp-python","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ptonelli%2Fmcp-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ptonelli%2Fmcp-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ptonelli%2Fmcp-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ptonelli%2Fmcp-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ptonelli","download_url":"https://codeload.github.com/ptonelli/mcp-python/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ptonelli%2Fmcp-python/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264505788,"owners_count":23618973,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["git","mcp-server","python3","shell"],"created_at":"2025-07-10T00:09:40.410Z","updated_at":"2025-07-10T00:09:45.627Z","avatar_url":"https://github.com/ptonelli.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Rationale\n\nI want my LLM to be able to read, modify and update my code. this implies it\nshould be able to:\n\n- read and write files and directories\n- run code (at least python)\n- install dependencies (uv or venv)\n\nNow on how I want to do it: This should run on its own : no need for an\nadditional machine or API access. The LLM must not have the ability to run\ncontainers. The setup must itself be running inside a container with a mounting\npoint for data to easily run on a home server.\n\n# Organisation\n\n2 sets of tools\n\n- shell prompt\n- code execution\n\n# Shell prompt (WIP)\n\nJust provide a shell prompt with the ability to set the current active directory.\n\n# Python execution (WIP)\n\nNo complex security, the python code must run and the LLM must be able to add its own deps to run the code.\n\n# Integration with Librechat\n\nTo integrate MCP Python with Librechat, you need to update the following configuration files:\n\n## docker-compose.yml\n\nAdd the following service configuration to your docker-compose.yml:\n\n```yaml\n  mcp_python:\n    container_name: mcp_python\n    image: docker.nautil.org/mcp-python:latest\n    environment:\n      - WORKDIR=/home/projects\n    volumes:\n      - ./projects:/home/projects\n```\n\n## librechat.yaml\n\nAdd the following MCP server configuration to your librechat.yaml:\n\n```yaml\nmcpServers:\n  python:\n    type: streamable-http\n    url: http://mcp_python:8000/mcp\n```\n\nThis setup allows Librechat to interact with the MCP Python service, providing code execution and file management capabilities to your LLM.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fptonelli%2Fmcp-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fptonelli%2Fmcp-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fptonelli%2Fmcp-python/lists"}