MCP Server Suite: Calculator + Gmail Integration

MCP Server Suite: Calculator + Gmail Integration

高度な計算機能とGmail連携を組み合わせた強力なModel Context Protocol（MCP）サーバースイートです。Claude Desktop MCP Clientを通じて複雑な数学計算を実行し、その結果をメールで送信できます。

🌟 機能

高度な計算機能

• 📱 複雑なBODMAS（括弧、累乗、除算、乗算、加算、減算）演算
• 🧮 高度な数学関数：
  • 三角関数（sin、cos、tan）
  • 指数関数および対数演算
  • 平方根および立方根
  • 階乗の計算
  • フィボナッチ数列の生成
• ✅ 段階的な推論の検証
• 📊 計算の整合性チェック

Gmail連携

• 📧 計算結果をメールで送信
• 📥 未読メールを取得して読む
• 🗑️ メールを管理（既読にする、ゴミ箱に移動する）
• 🌐 ブラウザーでメールを開く

🏗️ プロジェクト構成

MCP-Server-V4-Gmail/
├── calculator-mcp-server/       # Calculator MCP Server
│   ├── math-mcp-server/
│   │   ├── mcp_server.py       # Calculator implementation
│   │   └── models.py           # Data models
│   ├── pyproject.toml
│   └── README.md
└── gmail-mcp-server/           # Gmail MCP Server
    ├── src/
    │   └── gmail/
    │       ├── server.py       # Gmail integration
    │       └── __init__.py
    ├── pyproject.toml
    └── README.md

🚀 セットアップとインストール

前提条件

• Python 3.12以上
• Claude Desktop MCP Client
• Google Cloud Platformアカウント（Gmail API用）

1. Gmail APIのセットアップ

1. 新しいGoogle Cloudプロジェクトを作成します
2. Gmail APIを有効にします
3. OAuth同意画面を設定します：
   • 「external」を選択します（公開は不要です）
   • メールアドレスを「Test user」として追加します
4. OAuthスコープを追加します：https://www.googleapis.com/auth/gmail/modify
5. 「Desktop App」用のOAuth Client IDを作成します
6. OAuth認証情報のJSONファイルをダウンロードして保存します

2. サーバーのインストール

# Clone the repository
cd MCP-Server-V4-Gmail

# Set up Calculator Server
cd calculator-mcp-server
uv venv
uv pip install -r requirements.txt

# Set up Gmail Server
cd ../gmail-mcp-server
uv venv
uv pip install -r requirements.txt

3. Claude Desktopの設定

両方のサーバーをClaude Desktopの設定ファイル（~/Library/Application Support/Claude/claude_desktop_config.json）に追加します：

{
  "mcpServers": {
    "calculator": {
      "command": "uv",
      "args": [
        "--directory",
        "[path-to-repo]/calculator-mcp-server",
        "run",
        "mcp-server"
      ]
    },
    "gmail": {
      "command": "uv",
      "args": [
        "--directory",
        "[path-to-repo]/gmail-mcp-server",
        "run",
        "gmail",
        "--creds-file-path",
        "[path-to-credentials]/client_creds.json",
        "--token-path",
        "[path-to-tokens]/app_tokens.json"
      ]
    }
  }
}

💻 使用方法

1. Calculator Serverを起動します：

   cd calculator-mcp-server
   python math-mcp-server/mcp_server.py
   

2. Gmail Serverを起動します：

   cd gmail-mcp-server
   python src/gmail/server.py --creds-file-path [path]/client_creds.json --token-path [path]/app_tokens.json
   

3. Claude Desktopで使用します：

   • 計算を実行します：「Calculate 5 * (3 + 2) - 4 / 2」
   • 結果を送信します：「Send these calculation results to [email protected]」

📋 ワークフローの例

1. 複雑な式を計算します：

   User: Calculate (sin(45) + cos(30)) * sqrt(16)
   Claude: Let me break this down...
   [Shows step-by-step calculation]
   Result: 3.2834...
   

2. 結果をメールで送信します：

   User: Send this result to [email protected]
   Claude: I'll draft an email with the calculation results...
   [Shows email draft]
   Shall I send it?
   

🔒 セキュリティ

• Gmail APIは認証にOAuth 2.0を使用します
• トークンは指定された場所に安全に保存されます
• メール操作にはユーザーによる明示的な確認が必要です

📝 ライセンス

MITライセンス

👥 作成者

• Calculator Server：Saish Shetty
• Gmail Integration：原作者