Vault Python MCP Server

🚀 MCP 計算機サーバ

このサーバは、Model Context Protocol (MCP) を実装した基本的な計算機ツール付きのサーバです。Smithery にデプロイし、REST API を通じて算術演算を提供できます。

✨ 主な機能

• 基本的な算術演算（加算、減算、乗算、除算）
• MCP 互換の API エンドポイント
• JSON スキーマ検証
• エラー処理
• 複数の通信方式（HTTP、WebSocket、標準入出力）
• ローカルツールとリモートツールの統合をサポート

📦 インストール

仮想環境の作成と依存関係のインストール

1. プロジェクトディレクトリで仮想環境を作成してアクティブ化します。

   python -m venv env
   source env/bin/activate  # 对于 Unix/Mac
   # 或者
   .\env\Scripts\activate  # 对于 Windows
   

2. 依存関係をインストールします。

   pip install -r requirements.txt
   

💻 使用例

サーバの起動

HTTP モードでのサーバ起動

uvicorn server:app --host 0.0.0.0 --port 8000

WebSocket モードでのサーバ起動

python -m server.websocket_server

標準入出力モードでのサーバ起動

python -m server.stdin_stdout_server

📚 ドキュメント

API エンドポイント

HTTP モードのエンドポイント

• GET /：サーバの状態情報を返します。
• POST /add：2 つの数字を受け取り、その和を返します。
• POST /subtract：2 つの数字を受け取り、最初の数字から 2 番目の数字を引いた結果を返します。
• POST /multiply：2 つの数字を受け取り、その積を返します。
• POST /divide：2 つの数字を受け取り、最初の数字を 2 番目の数字で割った結果を返します。

WebSocket モードのエンドポイント

• ws://localhost:8001/ws：リアルタイムの対話型計算をサポートします。

エラー処理

• サーバは自動的にエラー情報をキャプチャして記録します。
• カスタムエラー処理ロジックをサポートします。

デプロイ方法

コンテナ化デプロイ（Docker）

HTTP モードでの Docker イメージ作成

# 使用官方 Python 基础镜像
FROM python:3.9-slim

# 设置工作目录
WORKDIR /app

# 复制依赖项和源文件
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制服务器代码
COPY server .

# 暴露端口 8000
EXPOSE 8000

# 设置启动命令
CMD ["uvicorn", "server:app", "--host", "0.0.0.0", "--port", "8000"]

標準入出力モードでの Docker イメージ作成

# 使用官方 Python 基础镜像
FROM python:3.9-slim

# 设置工作目录
WORKDIR /app

# 复制依赖项和源文件
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制服务器代码
COPY server .

# 暴露标准输入输出
EXPOSE 1

# 设置启动命令
CMD ["python", "-m", "server.stdin_stdout_server"]

統合設定

Smithery 設定（ローカルツール）

{
  "name": "calculator",
  "description": "一个基本计算器，能够执行算术运算",
  "command": ["python", "server.py"],
  "env": {
    "MCP_STDIO_MODE": "1",
    "LOGGING_CONFIG": "stdio"
  },
  "type": "local"
}

Smithery 設定（リモートツール）

{
  "name": "calculator",
  "description": "一个基本计算器，能够执行算术运算",
  "url": "http://your-container-host:8000/mcp",
  "type": "remote"
}

⚠️ 注意事項

• ローカルツールの統合には、標準入出力モード（MCP_STDIO_MODE=1）を使用し、LOGGING_CONFIG 環境変数を設定してください。
• コンテナ環境で実行する場合は、より信頼性の高いシグナル処理と起動プロセスを得るために、uvicorn の起動コマンドを直接使用することをお勧めします。

以上のドキュメントを参考にすることで、MCP 計算機サーバを様々なプロジェクトに簡単にデプロイして統合できます。