mmk-mcp

mmk-mcpは、Magic Meal KitsのためのModel Context Protocol(MCP)サーバーであり、AIアシスタントがサーバーのバージョン情報を確認するためのツールです。このサーバーは、Magic Meal Kits APIに接続し、構造化されたレスポンスを返すことで、プログラムから自然言語リクエストを通じてサーバーのバージョンを確認することを可能にします。また、APIキーを使用した安全な認証を行い、APIバックエンドとAI統合の間にクリーンな分離を維持します。

GitHubスター

0

ユーザー評価

未評価

お気に入り

0

閲覧数

15

フォーク

1

イシュー

1

インストール方法
難易度
中級
推定所要時間
10-20
必要な環境
Node.js: 18.0.0以上
npm: 8.0.0以上
+1 more

インストール方法

インストール方法

前提条件

必要なソフトウェアとバージョンを明記してください。
Node.js: 18.0.0以上
npm: 8.0.0以上
Claude Desktop: 最新版

インストール手順

1. リポジトリのクローン

bash
git clone https://github.com/pureugong/mmk-mcp
cd mmk-mcp

2. 依存関係のインストール

bash
npm install

3. Claude Desktop設定

claude_desktop_config.jsonを編集してMCPサーバーを追加:
json
{
  "mcpServers": {
    "magic-meal-kits": {
      "command": "npx",
      "args": ["-y", "mmk-mcp"],
      "env": {
        "MMK_API_KEY": "",
        "MMK_API_BASE_URL": ""
      }
    }
  }
}

4. サーバーの起動

bash
npm start

トラブルシューティング

よくある問題

問題: サーバーが起動しない 解決策: Node.jsのバージョンを確認し、依存関係を再インストールしてください。 問題: Claude Desktopで認識されない 解決策: 設定ファイルのパスと構文を確認してください。

設定方法

設定方法

基本設定

Claude Desktop設定

~/.config/claude-desktop/claude_desktop_config.json(macOS/Linux)または %APPDATA%\Claude\claude_desktop_config.json(Windows)を編集:
json
{
  "mcpServers": {
    "magic-meal-kits": {
      "command": "npx",
      "args": ["-y", "mmk-mcp"],
      "env": {
        "MMK_API_KEY": "your-api-key",
        "MMK_API_BASE_URL": "your-api-base-url"
      }
    }
  }
}

環境変数

必要に応じて以下の環境変数を設定:
bash
export MMK_API_KEY="your-api-key"
export MMK_API_BASE_URL="your-api-base-url"

詳細設定

セキュリティ設定

APIキーは環境変数または安全な設定ファイルに保存
ファイルアクセス権限の適切な設定
ログレベルの調整

パフォーマンス調整

タイムアウト値の設定
同時実行数の制限
キャッシュ設定

設定例

基本的な設定

json
{
  "mcpServers": {
    "magic-meal-kits": {
      "command": "npx",
      "args": ["-y", "mmk-mcp"],
      "env": {
        "MMK_API_KEY": "your-api-key",
        "MMK_API_BASE_URL": "your-api-base-url"
      }
    }
  }
}

使用例

使用例

基本的な使用方法

MCPサーバーの基本的な使用方法を以下に示します:

Claude Desktopでの使用

1MCPサーバーの起動確認
Claude Desktopを開き、設定が正しく読み込まれていることを確認してください。
2基本コマンドの実行

   Available tools from this MCP server:
   - magic_meal_kits_server_version: Check the Magic Meal Kits server version
   

プログラムでの使用

javascript
// JavaScript例(Node.js)
const { MCPClient } = require('@modelcontextprotocol/client');

const client = new MCPClient();
await client.connect();

// ツールの実行
const result = await client.callTool('magic_meal_kits_server_version', {});

console.log(result);

使用ケース

AIアシスタントがユーザーからのリクエストに基づいてMagic Meal Kitsのサーバーバージョンを確認する。
開発者がMCPサーバーを使用して、APIのバージョン管理を自動化する。
テスト環境でサーバーのバージョンを確認し、デプロイメントの整合性を保つ。
バージョン情報を取得するためのスクリプトを作成し、CI/CDパイプラインに組み込む。

追加リソース