食堂MCP

シンプルな API 統合を介して食堂のランチ メニューへのアクセスを提供するモデル コンテキスト プロトコル (MCP) サーバー。

説明

Canteen MCPは、FastMCPベースのサーバーで、食堂から毎日のランチメニューを取得するためのツールを公開しています。メニューAPIに接続し、特定の日付のメニューデータを照会するための構造化インターフェースを提供します。

Related MCP server: MCP Apple Calendars

特徴

• 特定の日付のランチメニューを入手

• リアルタイム通信のためのhttpStreamベースのトランスポート

• 環境ベースの構成

• 入力検証を備えた型安全なAPI

インストール

npm install

構成

サンプル環境ファイルをコピーし、値で更新します。

cp .env.example .env

環境変数

使用法

サーバーを起動します。

npm start

利用可能なツール

ランチメニューを取得する

特定の日付のランチ メニューを取得します。

• パラメータ:

  • date : YYYY-MM-DD形式の文字列

• 戻り値: メニューデータを含むJSON文字列

• 例：

  const result = await tool.execute({ date: "2024-10-05" });

発達

前提条件

• Node.js >= 18

• npm

開発モードで実行

npm run dev

ドッカー

イメージの構築

docker build -t canteen-mcp .

コンテナの実行

docker run -d \
  -p 8080:3000 \
  -e API_URL=your_api_url \
  -e PORT=3000 \
  -e ENDPOINT=/http \
  --name canteen-mcp \
  canteen-mcp

GitHub コンテナレジストリの使用

最新のイメージをプルします:

docker pull ghcr.io/[your-username]/canteen-mcp:latest

展開

Hetznerへの導入

1. Hetzner サーバーに SSH で接続します。

ssh root@your-server-ip

2. まだインストールされていない場合は Docker をインストールします。

curl -fsSL https://get.docker.com | sh

3. docker-compose.yml ファイルを作成します。

version: '3.8'
services:
  canteen-mcp:
    image: ghcr.io/c0dr/canteen-mcp:latest
    restart: always
    ports:
      - "8080:3000"
    environment:
      - API_URL=your_api_url
      - PORT=3000
      - ENDPOINT=/http

4. サービスを開始します:

docker-compose up -d

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

https://github.com/punkpeye/fastmcp-boilerplateに基づいています