Skip to content

Added details for setting up a development environment and running an MCP server locally #113

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

pcastagnaro
Copy link

Description of MCP Server Setup Script Lines

These lines outline the initial steps required to set up a local development environment for an MCP Server script, using uv as the package installer, which is recommended by the MCP ecosystem. This setup is crucial before you can begin developing or modifying your MCP server code.

  •   curl -LsSf https://astral.sh/uv/install.sh | sh

    Description: This command downloads and executes the installation script for uv, a fast Python package installer and dependency resolver. uv is recommended for its performance and efficiency within the MCP ecosystem, making it a preferred tool for managing project dependencies.

  •   source $HOME/.local/bin/env

    Description: After uv is installed, this command sources a script that adds uv's executable directory (typically $HOME/.local/bin) to your system's PATH environment variable. This allows you to run uv commands directly from any directory in your terminal without specifying the full path to the executable.

  •   uv --version

    Description: This command verifies that uv has been successfully installed and is accessible in your PATH. It prints the installed version of uv, confirming that you can proceed with using it for package management.

  •   python -m venv myenv && source myenv/bin/activate

    Description: This line creates a new Python virtual environment named myenv. Virtual environments are isolated Python environments that allow you to manage project-specific dependencies without interfering with your system's global Python packages. The && source myenv/bin/activate part then activates this newly created virtual environment, meaning any subsequent Python commands or package installations will apply only within myenv.

  •   uv pip install mcp

    Description: Inside the activated virtual environment, this command uses uv to install the core mcp library. This is the fundamental package required to run and develop applications within the Multi-Cloud Platform (MCP) framework.

  •   uv pip install "mcp[cli]"

    Description: This command installs the mcp library along with its command-line interface (CLI) dependencies. The [cli] extra ensures that all necessary components for interacting with MCP via the command line are available, providing utilities for development, deployment, and management.

  •   mcp dev server.py

    Description: Finally, this command runs your MCP server script (named server.py in this example) in development mode. The mcp dev command typically provides features like auto-reloading on code changes, detailed logging, and other developer-friendly functionalities, making it easier to test and debug your MCP server locally before deployment.


Copy link

@a-akimov a-akimov left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please review your last commit - it removed a lot of rows for the "MCP SDKs" table, as well as the "Next Steps section" - it doesn't look in line with the main description of this PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants