Hermes Grocy MCP

Name: Hermes Grocy MCP
Author: rusty4444

โดย rusty4444รุ่น 0.2.1i★ –iรันบนเครื่อง

ชื่อใน registryio.github.rusty4444/hermes-grocy-mcp

ติดตั้ง

ภาพรวม

คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)

MCP server for Grocy household ERP inventory and shopping workflows.

สามเสาของ PopNx MCP

สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน

เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
ผลตรวจเบื้องต้นของเราiผ่าน 1 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
การใช้งานiยังไม่ได้วัด★ –

ใช้ทำอะไรได้

ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry

การเชื่อมต่อ: รันบนเครื่อง
ช่องทาง (transport): stdio
หมวด: ร้านค้าออนไลน์และรับเงิน
ต้องใส่ค่าเหล่านี้: GROCY_API_KEY

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ก่อนติดตั้ง

ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
ค่าที่คุณต้องใส่เอง: GROCY_BASE_URL, GROCY_API_KEY

ค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต

ต้องเตรียมก่อน

PyPIติดตั้ง uv ของ Python (มีคำสั่ง uvx) ในเครื่อง

คุณใช้แอปไหน

ClaudeClaude CodeCursorVS CodeChatGPT

เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”

เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json

{
  "mcpServers": {
    "hermes-grocy": {
      "command": "uvx",
      "args": [
        "hermes-grocy-mcp"
      ],
      "env": {
        "GROCY_BASE_URL": "ใส่ค่าของคุณ",
        "GROCY_API_KEY": "ใส่ค่าของคุณ"
      }
    }
  }
}

พิมพ์คำสั่งนี้ใน Terminal

claude mcp add hermes-grocy --env GROCY_BASE_URL='ใส่ค่าของคุณ' --env GROCY_API_KEY='ใส่ค่าของคุณ' -- uvx hermes-grocy-mcp

เติมค่าที่เว้นว่างไว้ก่อนรัน

เปิดใน Cursor

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json

{
  "mcpServers": {
    "hermes-grocy": {
      "command": "uvx",
      "args": [
        "hermes-grocy-mcp"
      ],
      "env": {
        "GROCY_BASE_URL": "ใส่ค่าของคุณ",
        "GROCY_API_KEY": "ใส่ค่าของคุณ"
      }
    }
  }
}

เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง

เปิดใน VS Code

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .vscode/mcp.json ของโปรเจกต์

{
  "servers": {
    "hermes-grocy": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "hermes-grocy-mcp"
      ],
      "env": {
        "GROCY_BASE_URL": "ใส่ค่าของคุณ",
        "GROCY_API_KEY": "ใส่ค่าของคุณ"
      }
    }
  }
}

ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น

ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี

ค่าที่ต้องใส่เอง

GROCY_BASE_URL env
Grocy base URL, with or without /api
GROCY_API_KEY ความลับ env
Grocy API key for private instances or write access

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

ทำอะไรได้บ้าง

รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 7 พ.ย. 2569

✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub rusty4444 ซึ่งเป็นเจ้าของ repo
… ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
… ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
– ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
– ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
… ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

เทียบกับตัวอื่นในหมวด ร้านค้าออนไลน์และรับเงินi

ดาวมากกว่า 0% ของอีก 2535 ตัวในหมวดนี้
ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 8% ของอีก 2535 ตัวในหมวดนี้
ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 2535 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Hermes Grocy MCP ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

ต้องใส่ค่าเหล่านี้: GROCY_API_KEY

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.2.1) เข้า registry 6 เดือนที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Python (uv) ในเครื่องด้วย

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce

ตัวที่ใช้แทนได้

server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว

อ่านการ์ด:★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

Spree Commerce: open-source B2B and marketplace ecommerce

โดย spree

Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.

รันบนคลาวด์★ 15,812BSD-3-Clauseอัปเดต 8 วันที่ผ่านมา

ติดตั้ง

Stripe MCP

โดย stripe

server ทางการของ Stripe ให้ AI ดูและจัดการลูกค้า สินค้า การชำระเงิน และใบแจ้งหนี้ ต่อผ่านคลาวด์ของ Stripe และล็อกอินแบบ OAuth

รันบนคลาวด์★ 2,043MITอัปเดต 12 เดือนที่ผ่านมา

ติดตั้ง

MCP Cn Commerce

โดย TonyWang-hub

8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending

รันบนเครื่อง★ 96MITอัปเดต 28 วันที่ผ่านมา

ติดตั้ง

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

Grocy MCP

A Model Context Protocol (MCP) server for Grocy, the self-hosted household ERP for groceries, inventory, chores, batteries, recipes, tasks, and shopping lists.

This server focuses on AI-friendly household operations that are awkward through generic REST clients:

Inspect Grocy system/version status
List, search, and inspect products
Read current stock, volatile stock, product stock details, and individual stock entries
List current shopping list items and add/remove products from shopping lists
Look up products by barcode/Grocycode
List and inspect any /api/objects/{entity} entity
Create/update generic entity objects from JSON
Add, consume, and inventory product stock
Add/remove product amounts from shopping lists

Why this exists

Grocy has a strong REST API, but MCP coverage is sparse and usually either incomplete or tightly coupled to one client's workflow. This package gives Hermes, Claude Desktop, Cursor, and other MCP clients a small, explicit, documented tool surface.

Installation

pipx install git+https://github.com/rusty4444/grocy-mcp.git

Or from a checkout:

python -m venv .venv

source .venv/bin/activate pip install -e .

Configuration

The server reads configuration from environment variables:

Variable	Required	Default	Description
`GROCY_BASE_URL`	No	`https://demo.grocy.info`	Grocy base URL, with or without `/api`
`GROCY_API_KEY`	No for public/demo read-only instances, yes for private/write access	unset	Grocy API key sent as `GROCY-API-KEY`
`GROCY_TIMEOUT`	No	`20`	HTTP timeout in seconds

Grocy API keys are managed in Grocy under Manage API keys. The API accepts the GROCY-API-KEY header.

MCP client config

"mcpServers": { "grocy": { "command": "grocy-mcp", "env": { "GROCY_BASE_URL": "https://grocy.example.com", "GROCY_API_KEY": "your-api-key" } } } }

Tools

Tool	Purpose
`grocy_system_info`	Grocy version and runtime details
`grocy_list_products`	List configured products
`grocy_search_products`	Search products by name/description
`grocy_get_product`	Fetch one product object
`grocy_lookup_product_by_barcode`	Resolve a barcode/Grocycode
`grocy_stock_overview`	Current stock rows
`grocy_volatile_stock`	Due, overdue, expired, or missing products
`grocy_product_stock_details`	Detailed stock state for one product
`grocy_product_stock_entries`	Individual stock entries in next-use order
`grocy_common_entities`	Common generic entity names useful with CRUD tools
`grocy_list_shopping_lists`	Configured shopping lists
`grocy_list_shopping_list_items`	Current shopping list rows, optionally filtered by list id
`grocy_list_entity`	List any generic Grocy entity
`grocy_get_entity_object`	Fetch any generic entity object
`grocy_create_entity_object`	POST a generic entity object from JSON
`grocy_update_entity_object`	PUT a generic entity object from JSON
`grocy_add_stock`	Add product amount to stock
`grocy_consume_stock`	Consume/remove product amount from stock
`grocy_inventory_product`	Set product inventory amount
`grocy_add_product_to_shopping_list`	Add a product to a shopping list
`grocy_remove_product_from_shopping_list`	Remove a product from a shopping list
`grocy_set_userfields`	Set userfield values on an entity object
`grocy_list_chores`	List chores including computed next-due times
`grocy_execute_chore`	Execute (mark done) a chore, optionally backdated
`grocy_list_tasks`	List tasks

Development and validation

python -m venv .venv

source .venv/bin/activate pip install -e '.[dev]' ruff check . pytest python scripts/live_readonly_test.py

The live read-only test defaults to https://demo.grocy.info, avoiding mutations on shared infrastructure. It has been validated against Grocy API 4.6.0. Use a private Grocy instance plus GROCY_API_KEY for write-path testing.

Safety

Write-capable tools directly mutate Grocy data. Prefer read-only tools when using public demos. Keep GROCY_API_KEY in MCP client environment config or a secret manager, never in source control.

Hermes Grocy MCP

ภาพรวม

สามเสาของ PopNx MCP

ใช้ทำอะไรได้

ติดตั้ง

ก่อนติดตั้ง

ค่าที่ต้องใส่เอง

ทำอะไรได้บ้าง

ผลตรวจเบื้องต้นi

ตัวตนผู้ทำตรงกับ repo

ยังมีคนดูแล

มีสัญญาอนุญาต (license)

endpoint ตอบ

ล็อกอินแบบ OAuth

คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

เทียบกับตัวอื่นในหมวด ร้านค้าออนไลน์และรับเงินi

คำถามที่พบบ่อย

ตัวที่ใช้แทนได้

Spree Commerce: open-source B2B and marketplace ecommerce

Stripe MCP

MCP Cn Commerce

README จากผู้ทำ

Grocy MCP

Why this exists

Installation

Configuration

MCP client config

Tools

Development and validation

Safety