高性能数学计算服务器

┌─────────────────┐    ┌─────────────────┐
│   Claude Desktop │    │   Llamastack   │
│                 │    │   / Web Apps    │
└─────────┬───────┘    └─────────┬───────┘
          │                      │
          │ JSON-RPC             │ HTTP/REST
          │ (stdin/stdout)       │ (TCP:8080)
          │                      │
          ▼                      ▼
┌─────────────────────────────────────────┐
│           Calculator Core               │
│    (Shared Rust Implementation)        │
└─────────────────────────────────────────┘

# Clone the repository
git clone <your-repo-url>
cd calculator-mcp-server

# Build both MCP and HTTP servers
make all

# Package for Claude Desktop
make pack-mcp

# Install the generated calculator-mcp-server.dxt file in Claude Desktop
# Settings > Extensions > Install Extension

# Start HTTP server
make test-http

# Server runs on http://localhost:8080

"Calculate the factorial of 15"
"Convert binary 1101 to hexadecimal" 
"What's the combination C(10,3)?"
"Calculate statistics for: 23, 45, 12, 67, 34, 89, 56"

curl http://localhost:8080/health

curl -X POST http://localhost:8080/factorial \
  -H 'Content-Type: application/json' \
  -d '{"n": 20}'

curl -X POST http://localhost:8080/convert \
  -H 'Content-Type: application/json' \
  -d '{"value": "FF", "from_base": 16, "to_base": 2}'

curl -X POST http://localhost:8080/arithmetic \
  -H 'Content-Type: application/json' \
  -d '{"operation": "multiply", "operands": [12, 15, 8]}'

calculator-mcp-server/
├── src/
│   ├── lib.rs           # Shared calculator logic
│   ├── mcp_server.rs    # MCP JSON-RPC server
│   └── http_server.rs   # HTTP API server (Axum)
├── Makefile            # Build automation
├── manifest.json       # MCP extension manifest
└── README.md          # This file

make build-mcp      # Build MCP server only
make build-http     # Build HTTP server only  
make pack-mcp       # Package for Claude Desktop
make test-mcp       # Test MCP server
make test-http      # Start HTTP server for testing
make clean          # Clean build artifacts
make help           # Show all commands

# Test MCP server
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | ./target/release/mcp-server

# Test HTTP endpoints
curl http://localhost:8080/tools
curl -X POST http://localhost:8080/factorial -H 'Content-Type: application/json' -d '{"n": 12}'

http://localhost:8080

{
  "status": "healthy",
  "version": "1.0.0"
}

{
  "tools": [
    {
      "name": "basic_arithmetic",
      "description": "Basic arithmetic operations",
      "parameters": {...}
    }
  ]
}

{
  "tool": "factorial_combinatorics",
  "arguments": {
    "operation": "factorial",
    "n": 15
  }
}

{
  "success": true,
  "result": "1307674368000",
  "calculation_details": {
    "operation": "15!",
    "result": "1307674368000",
    "decimal_approximation": 1307674368000.0,
    "calculation_time_ms": 0
  }
}

import requests

class CalculatorClient:
    def __init__(self, base_url="http://localhost:8080"):
        self.base_url = base_url
    
    def factorial(self, n):
        response = requests.post(f"{self.base_url}/factorial", 
                               json={"n": n})
        return response.json()
    
    def convert_base(self, value, from_base, to_base):
        response = requests.post(f"{self.base_url}/convert", 
                               json={
                                   "value": value, 
                                   "from_base": from_base, 
                                   "to_base": to_base
                               })
        return response.json()

# Usage
calc = CalculatorClient()
result = calc.factorial(20)
print(f"20! = {result['result']}")

class CalculatorClient {
    constructor(baseUrl = 'http://localhost:8080') {
        this.baseUrl = baseUrl;
    }
    
    async factorial(n) {
        const response = await fetch(`${this.baseUrl}/factorial`, {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({ n })
        });
        return await response.json();
    }
    
    async convertBase(value, fromBase, toBase) {
        const response = await fetch(`${this.baseUrl}/convert`, {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({ 
                value, 
                from_base: fromBase, 
                to_base: toBase 
            })
        });
        return await response.json();
    }
}

// Usage
const calc = new CalculatorClient();
const result = await calc.factorial(15);
console.log(`15! = ${result.result}`);

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Clone and build
git clone <repo-url>
cd calculator-mcp-server
make all