Skip to main content
Glama
Sign In
mcp-pypi

mcp-pypi

by UjjwalKo
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

mcp-pypi

What this project is

This project is an MCP server built with FastMCP. It exposes tools that give an MCP client or agent basic terminal abilities, such as running commands, running Python, and working with files and folders. The server uses the MCP stdio transport, so it communicates over standard input and output and is meant to be started by an MCP client.

Related MCP server: My Awesome MCP

What it does

  1. Starts an MCP server over stdio.

  2. Registers a set of tools that act on the local machine.

MCP tools

The server provides these tools:

Tool

Purpose

Notes

bash(command: str)

Run a shell command.

Uses the system shell. Returns stderr on error. On success, it does not return a value in the current implementation.

python_code(code: str)

Run Python code.

Executes python -c <code>. Returns stdout or error text.

python_file(file: str)

Run a Python file.

Executes python <file>. Returns stdout or error text.

glob(pattern: str)

Find files by pattern.

Returns a list of matching paths.

grep(pattern: str, file: str)

Search for a pattern in a file.

Uses findstr on Windows. Prints matches and does not return a value in the current implementation.

read_file(file: str)

Read a file.

Returns file content or error text.

write_file(file: str, content: str)

Write a file.

Overwrites if the file exists and returns a success message or error text.

create_folder(folder: str)

Create a folder.

Returns a message if it was created or already exists.

delete_folder(folder: str)

Delete a folder.

Recursively removes the folder if it exists and returns a message.

Install

Python 3.10 or later is required.

From the repository root:

python -m pip install .

Run as an MCP server

Start the server with the stdio transport:

mcp_pypi

Or:

python -m mcp_pypi.main

Then configure your MCP client to launch it with stdio. Example:

{
  "mcpServers": {
    "mcp-pypi": {
      "command": "mcp_pypi",
      "args": []
    }
  }
}

Project layout

  1. src/mcp_pypi/tools.py defines the MCP tools.

  2. src/mcp_pypi/main.py starts the MCP server over stdio.

  3. test.py starts the server directly for quick local runs.

Available Tools

9 tools
bashC

This function will execute a bash command and return the output. This function is useful for executing commands including creating files, directories, and other shell commands.

Inputs: command (required).

create_folderA

This function will create a folder with the given name. If the folder already exists, it will return a message indicating that the folder already exists.

Inputs: folder (required).

delete_folderB

This function will delete a folder with the given name. If the folder does not exist, it will return a message indicating that the folder does not exist.

Inputs: folder (required).

globC

This function will return a list of files that match the given pattern.

Inputs: pattern (required).

grepB

This function will search for a given pattern in the specified file and return the matching lines.

Inputs: file (required), pattern (required).

python_codeB

This function will execute a python code and return the output.

Inputs: code (required).

python_fileB

This function will execute a python file and return the output.

Inputs: file (required).

read_fileB

This function will read the contents of a file and return it as a string.

Inputs: file (required).

write_fileA

This function will write the given content to a file. If the file does not exist, it will be created. If the file already exists, it will be overwritten.

Inputs: file (required), content (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    C2.9/5.0

    Scored across 9 tools

    Disambiguation4/5

    Tools have distinct purposes (code execution, bash, file ops, search), but some overlap exists between python_code and python_file; both execute Python code, differing only in input type (string vs file).

    Naming Consistency3/5

    Most tools use snake_case, but naming patterns vary: verb_noun for file ops (read_file, write_file, create_folder), single words for others (bash, glob, grep), and adjective_noun for python_code and python_file.

    Tool Count4/5

    9 tools is reasonable for a general utility server providing file system and command execution capabilities, though the server name suggests a PyPI focus, which is mismatched.

    Completeness3/5

    Covers basic file and command operations but lacks common features like file copy/move/rename, directory listing beyond glob, or process management, leaving notable gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • MCP Shell Server

      IsaacCode0107
      F
      license
      Not graded
      quality
      Not graded
      maintenance
      A simple MCP server that provides a terminal tool for executing shell commands with safety features like timeouts and error handling.
      -

    • My Awesome MCP

      elliotnorrevik
      -
      license
      Not graded
      quality
      Not graded
      maintenance
      A basic MCP server built with FastMCP framework that provides example tools including message echoing and server information retrieval. Supports both stdio and HTTP transports with Docker deployment capabilities.
      -

    • DDG MCP Server

      elliotnorrevik
      -
      license
      Not graded
      quality
      Not graded
      maintenance
      A basic MCP server built with FastMCP framework that provides example tools including message echoing and server information retrieval. Supports both stdio and HTTP transports with Docker deployment capabilities.
      -

    • DDG MCP Server

      elliotnorrevik
      -
      license
      Not graded
      quality
      Not graded
      maintenance
      A basic MCP server built with FastMCP framework that provides example tools including message echoing and server information retrieval. Supports both stdio and HTTP transports for integration with various MCP clients.
      -