joseph_mcp_server

Joseph19820124/joseph_mcp_server

3.1

If you are the rightful owner of joseph_mcp_server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This document provides a comprehensive guide to setting up and running a Model Context Protocol (MCP) server using FastMCP, a lightweight and efficient framework for MCP server implementation.

Example MCP Server using FastMCP

Prerequisites

  • uv
  • python 3.12

Install

After checking out the repo, run uv venv and uv sync

How to run

on Mac (replace folder name with the root of the repo)

uv run --python /Users/chenjian/Documents/ai_projects/my_mcp_server/.venv/bin/python fastmcp run /Users/chenjian/Documents/ai_projects/my_mcp_server/main.py

or

uv run -p /Users/chenjian/Documents/ai_projects/my_mcp_server/.venv/bin/python fastmcp run /Users/chenjian/Documents/ai_projects/my_mcp_server/main.py

Adding this MCP on IDEs

  • With Claude Desktop and cursor
{
  "mcpServers": {
    "my_mcp_server": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--python",
        "/Users/chenjian/Documents/ai_projects/.venv/bin/python",
        "fastmcp",
        "run",
        "/Users/chenjian/Documents/ai_projects/my_mcp_server/main.py"
      ]
    }
  }
}
  • With Claude Code
claude mcp add uv run --python /Users/chenjian/Documents/ai_projects/my_mcp_server/.venv/bin/python fastmcp run /Users/chenjian/Documents/ai_projects/my_mcp_server/main.py

or

claude mcp add uv run -p /Users/chenjian/Documents/ai_projects/my_mcp_server/.venv/bin/python fastmcp run /Users/chenjian/Documents/ai_projects/my_mcp_server/main.py