CalcMCP/DEPLOYMENT.md

MCP Scientific Calculator - Deployment Guide

Pre-Deployment Checklist

✅ Completed:

• 3 consolidated tools tested (symbolic_tool, numpy_tool, scipy_tool)
• 10 advanced math problems validated
• MCP specification compliance verified
• README.md with service introduction and configuration
• LICENSE file (MIT)
• setup.py for PyPI packaging

Deployment Steps

1. GitHub Repository Setup

Create a new repository:

# Initialize git (if not already done)
cd F:\AAchengguoofAI\cuz_caculat
git init

# Add all files
git add .
git commit -m "Initial release: MCP Scientific Calculator v1.0.0"

# Create GitHub repo and push
# Go to https://github.com/new
# Repository name: mcp-scientific-calculator
# Public repository
# Then:
git remote add origin https://github.com/YOUR_USERNAME/mcp-scientific-calculator.git
git branch -M main
git push -u origin main

Repository structure (current):

mcp-scientific-calculator/
├── README.md                      # ✅ Service introduction (required)
├── LICENSE                        # ✅ MIT License
├── setup.py                       # ✅ PyPI packaging
├── pyproject.toml                 # ✅ Python project metadata
├── requirements.txt               # ✅ Dependencies
├── calculator.py                  # Core calculation library
├── mcp_server.py                  # MCP server implementation
├── advanced_math_problems.py      # Problem set
├── advanced_math_problems.json    # Problem data
├── verify_production_readiness.py # Testing script
└── .gitignore                     # Git ignore rules

2. PyPI Publishing (Required by MCP Community)

Prepare for PyPI:

# Install build tools
pip install build twine

# Build distribution packages
python -m build

# This creates:
# dist/mcp-scientific-calculator-1.0.0.tar.gz
# dist/mcp_scientific_calculator-1.0.0-py3-none-any.whl

Test with TestPyPI first:

# Upload to TestPyPI
python -m twine upload --repository testpypi dist/*

# Test installation
pip install --index-url https://test.pypi.org/simple/ mcp-scientific-calculator

Publish to PyPI:

# Create PyPI account at https://pypi.org/account/register/
# Create API token at https://pypi.org/manage/account/token/

# Upload to PyPI
python -m twine upload dist/*

# Installation command (for users):
pip install mcp-scientific-calculator

3. MCP Community Submission

Required information (auto-extracted from README.md):

1. Service Introduction: ✅ First paragraph of README.md

   "A production-ready Model Context Protocol (MCP) server providing advanced mathematical calculation capabilities for AI models. Supports symbolic math (SymPy), numerical computing (NumPy/SciPy), data analysis (pandas), and image processing."

2. Service Configuration: ✅ Server config section in README.md

   {
     "mcpServers": {
       "scientific-calculator": {
         "command": "python",
         "args": ["-u", "path/to/mcp_server.py"],
         "env": {}
       }
     }
   }
   

3. Environment Variables: ✅ Empty env object (no env vars required)

4. Type/Category: Will be auto-detected as "Mathematics" or "Developer Tools"

5. Service Description: AI will summarize README.md content

Submit to MCP Community:

• Go to MCP community submission portal
• Provide GitHub repository URL: https://github.com/YOUR_USERNAME/mcp-scientific-calculator
• Provide PyPI package name: mcp-scientific-calculator
• System will auto-validate README.md and extract configuration
• Review and submit

4. Post-Deployment

Create GitHub Release:

# Tag the release
git tag -a v1.0.0 -m "Release v1.0.0: Production-ready MCP calculator"
git push origin v1.0.0

On GitHub:

• Go to Releases → Create new release
• Choose tag: v1.0.0
• Release title: "MCP Scientific Calculator v1.0.0"
• Description: Copy features section from README.md
• Attach dist/.whl and dist/.tar.gz files

Update README badges:

• PyPI version badge (auto-updates)
• License badge (already included)
• Add GitHub stars/forks badges if desired

Validation Checklist

Before submitting to MCP community:

• README.md has clear service introduction (first paragraph)
• README.md has complete server configuration with JSON example
• GitHub repository is public
• PyPI package is published and installable
• LICENSE file exists
• All tools tested and working (run python test_tools.py)
• Repository URL and PyPI name match

Installation Test (End User)

# Install from PyPI
pip install mcp-scientific-calculator

# Clone repository
git clone https://github.com/YOUR_USERNAME/mcp-scientific-calculator.git
cd mcp-scientific-calculator

# Add to Claude Desktop config
# Edit %APPDATA%\Claude\claude_desktop_config.json (Windows)
# or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
{
  "mcpServers": {
    "scientific-calculator": {
      "command": "python",
      "args": ["-u", "/path/to/mcp_server.py"]
    }
  }
}

# Restart Claude Desktop
# Tools will appear: symbolic_tool, numpy_tool, scipy_tool

Support & Documentation

• GitHub Issues: https://github.com/YOUR_USERNAME/mcp-scientific-calculator/issues
• PyPI Page: https://pypi.org/project/mcp-scientific-calculator/
• MCP Specification: https://modelcontextprotocol.io/docs/develop/build-server