Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)
MCP-сервер Инвойсбокса: счета, отгрузки и возвраты по просьбе человека
สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน
ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
INVOICEBOX_API_TOKEN, INVOICEBOX_MERCHANT_ID, INVOICEBOX_ENV, INVOICEBOX_TOOLSETS, INVOICEBOX_STATE_DIRค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต
ต้องเตรียมก่อน
คุณใช้แอปไหน
เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”
เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json
{
"mcpServers": {
"invoicebox": {
"command": "npx",
"args": [
"-y",
"@invoicebox/mcp-server"
],
"env": {
"INVOICEBOX_API_TOKEN": "ใส่ค่าของคุณ",
"INVOICEBOX_MERCHANT_ID": "ใส่ค่าของคุณ",
"INVOICEBOX_ENV": "ใส่ค่าของคุณ",
"INVOICEBOX_TOOLSETS": "ใส่ค่าของคุณ",
"INVOICEBOX_STATE_DIR": "ใส่ค่าของคุณ"
}
}
}
}พิมพ์คำสั่งนี้ใน Terminal
claude mcp add invoicebox --env INVOICEBOX_API_TOKEN='ใส่ค่าของคุณ' --env INVOICEBOX_MERCHANT_ID='ใส่ค่าของคุณ' --env INVOICEBOX_ENV='ใส่ค่าของคุณ' --env INVOICEBOX_TOOLSETS='ใส่ค่าของคุณ' --env INVOICEBOX_STATE_DIR='ใส่ค่าของคุณ' -- npx -y @invoicebox/mcp-serverเติมค่าที่เว้นว่างไว้ก่อนรัน
วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json
{
"mcpServers": {
"invoicebox": {
"command": "npx",
"args": [
"-y",
"@invoicebox/mcp-server"
],
"env": {
"INVOICEBOX_API_TOKEN": "ใส่ค่าของคุณ",
"INVOICEBOX_MERCHANT_ID": "ใส่ค่าของคุณ",
"INVOICEBOX_ENV": "ใส่ค่าของคุณ",
"INVOICEBOX_TOOLSETS": "ใส่ค่าของคุณ",
"INVOICEBOX_STATE_DIR": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
วางในไฟล์ .vscode/mcp.json ของโปรเจกต์
{
"servers": {
"invoicebox": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@invoicebox/mcp-server"
],
"env": {
"INVOICEBOX_API_TOKEN": "ใส่ค่าของคุณ",
"INVOICEBOX_MERCHANT_ID": "ใส่ค่าของคุณ",
"INVOICEBOX_ENV": "ใส่ค่าของคุณ",
"INVOICEBOX_TOOLSETS": "ใส่ค่าของคุณ",
"INVOICEBOX_STATE_DIR": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น
ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี
INVOICEBOX_ENV envINVOICEBOX_TOOLSETS envINVOICEBOX_STATE_DIR envค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 6 พ.ย. 2569
ชื่อใน registry ยืนยันโดเมน invoicebox.ru แล้ว (registry ตรวจความเป็นเจ้าของโดเมน)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใส่ค่าเหล่านี้: INVOICEBOX_API_TOKEN, INVOICEBOX_MERCHANT_ID
รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)
repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.2.1) เข้า registry 3 เดือนที่ผ่านมา
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Node.js ในเครื่องด้วย
ในหมวดเดียวกันมี Spec Driven Development, Remote Desktop Commander, zanadir
server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว
อ่านการ์ด:★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Find what a repository's CI is missing, and which security checks cannot fail the build.
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
Сервер Model Context Protocol для Инвойсбокса: ассистент выставляет счёт организации, ИП или физическому лицу, проверяет оплату, подтверждает отгрузку — а по ней формируются закрывающие документы, — и возвращает деньги. Всё по просьбе человека и с его подтверждением.
Права по умолчанию — только чтение. Ни одна операция с деньгами не выполняется в один вызов.
Демонстрационный магазин опубликован в документации (авторизация), поэтому попробовать можно без своего договора. Он общий для всех читателей: пробные счета видны всем, поэтому реальные реквизиты и персональные данные в демо не вводите.
INVOICEBOX_API_TOKEN=b37c4c689295904ed21eee5d9a48d42e INVOICEBOX_MERCHANT_ID=ffffffff-ffff-ffff-ffff-ffffffffffff INVOICEBOX_ENV=demo npx -y @invoicebox/mcp-server
Записи включаются явно: INVOICEBOX_TOOLSETS=write добавляет счёт, отмену и отгрузку, refund — возврат. Токен можно не держать в переменной окружения: invoicebox-mcp-server login <токен> кладёт его в файл с правами только для владельца.
Пример конфигурации клиента MCP:
{
"mcpServers": { "invoicebox": { "command": "npx", "args": ["-y", "@invoicebox/mcp-server@0.2.1"], "env": { "INVOICEBOX_API_TOKEN": "b37c4c689295904ed21eee5d9a48d42e", "INVOICEBOX_MERCHANT_ID": "ffffffff-ffff-ffff-ffff-ffffffffffff", "INVOICEBOX_ENV": "demo", "INVOICEBOX_TOOLSETS": "read" } } } }
Версию указывайте всегда: у платёжного инструмента latest означает, что набор инструментов может измениться между двумя запусками одного и того же диалога.
| Инструмент | Что делает | Подтверждение |
|---|---|---|
lookup_company_by_inn | Реквизиты организации или ИП по ИНН | нет |
get_order | Счёт по идентификатору или по своему номеру | нет |
find_orders | Срез по счетам: номер, статус, даты, суммы | нет |
find_shipments | Что по заказу отгружено и в каком статусе | нет |
create_order | Выставляет счёт, возвращает ссылку на оплату | двухфазное |
cancel_order | Отменяет неоплаченный счёт | двухфазное |
create_shipment | Подтверждает отгрузку, по ней идут акт, счёт-фактура и УПД | двухфазное |
create_refund | Возвращает деньги полностью или по составу | двухфазное |
Полный справочник с параметрами — https://docs.invoicebox.ru/mcp/tools/
"12200" это 122,00 ₽. Так модель не теряет копейку на числе с плавающей точкой.amount и amount_wo_vat в позиции относятся к одной единице, total_amount и total_vat_amount — ко всему количеству.legal (у ИП ИНН из 12 цифр и без КПП) и private.create_shipment.| Переменная | Обязательна | Назначение |
|---|---|---|
INVOICEBOX_API_TOKEN | да, если нет файла токена | Токен из личного кабинета, вкладка «Интеграция (API)» |
INVOICEBOX_ENV | да | demo или production; демо — магазин в тестовом режиме |
INVOICEBOX_MERCHANT_ID | для операций магазина | Идентификатор магазина |
INVOICEBOX_COUNTERPARTY_ID | для операций организации | Идентификатор организации |
INVOICEBOX_TOOLSETS | нет | read по умолчанию, плюс write и refund |
INVOICEBOX_STATE_DIR | нет | Каталог журнала и защиты от дублей; без него она живёт только в пределах запуска |
INVOICEBOX_RATE_LIMIT | нет | Свой ограничитель, запросы/секунды; по умолчанию 60/30 |
INVOICEBOX_LIMITS | нет | Суточные потолки, JSON |
INVOICEBOX_CONFIRM_THRESHOLD | нет | Порог суммы в копейках для отдельного подтверждения |
INVOICEBOX_LOG_LEVEL | нет | error, warn, info, debug |
INVOICEBOX_GRAYLOG_URL, INVOICEBOX_SENTRY_DSN | нет | Внешние приёмники журнала; выключены по умолчанию |
INVOICEBOX_TOKEN_FILE | нет | Свой путь к файлу токена |
INVOICEBOX_HTTP_PORT | нет | Задан — транспорт Streamable HTTP на этом порту, иначе stdio |
INVOICEBOX_HTTP_HOST | нет | Адрес привязки HTTP; по умолчанию 127.0.0.1 |
INVOICEBOX_HTTP_ALLOWED_HOSTS, INVOICEBOX_HTTP_ALLOWED_ORIGINS | нет | Белые списки Host и Origin; по умолчанию наружу закрыто |
INVOICEBOX_HTTP_SESSION_IDLE_MS, INVOICEBOX_HTTP_MAX_SESSIONS | нет | Срок жизни сессии (30 минут) и их потолок (200) |
Полный список настроек — https://docs.invoicebox.ru/mcp/quickstart/
Набор по умолчанию занимает около 1 100 токенов описаний, полный набор с возвратами — около 4 000. Выборка двадцати счетов стоит примерно 1 200 токенов в кратком формате и 2 900 в подробном. Ответы усекаются с явной пометкой, страница ограничена пятьюдесятью записями. Замеры и приёмы — https://docs.invoicebox.ru/mcp/tokens/
npm ci
npm run typecheck npm run lint npm test npm run build
Что менялось между версиями — в файле CHANGELOG.md внутри пакета (npm view @invoicebox/mcp-server versions покажет список выпусков). Версию в конфигурации указывайте явно: у платёжного инструмента latest означает, что набор инструментов может измениться между двумя запусками одного диалога.
Вопросы и доступ к бете — https://www.invoicebox.ru/ru/contacts