食堂MCP

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

説明

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

Related MCP server: MCP Apple Calendars

特徴

特定の日付のランチメニューを入手
リアルタイム通信のためのhttpStreamベースのトランスポート
環境ベースの構成
入力検証を備えた型安全なAPI

インストール

npm install

構成

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

cp .env.example .env

環境変数

変数	説明	例
API_URL	ランチメニューAPIのURL	https://lunch-menu-ai.vercel.app/api/v1/menu
ポート	MCP サーバーのポート	8080
終点	HTTPエンドポイント	/終点

使用法

サーバーを起動します。

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への導入

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

ssh root@your-server-ip

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

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

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