Memungkinkan AI client untuk membaca dan menulis catatan sapi serta domba melalui MCP server lokal dengan akses berbasis lingkup peternakan.
Juga dikenal sebagai RanchBot/mcp-server, @ranchbot/mcp-server
- Stars
- 1
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.2.0
- Commit terakhir
- 20 Okt 2026
- Lisensi
- MIT
Apa itu Ranch.Bot MCP?
Memungkinkan AI client untuk membaca dan menulis catatan sapi serta domba melalui MCP server lokal dengan akses berbasis lingkup peternakan.
Ringkasan dibuat dari README proyek
Tentang Ranch.Bot MCP server
Mengelola data ternak melalui asisten AI kini dimungkinkan dengan MCP server lokal yang terhubung ke akun Ranch.Bot Anda. Dirancang khusus untuk produsen, server ini memungkinkan AI client untuk membaca dan menulis catatan sapi serta domba menggunakan transport stdio. Server ini beroperasi berdasarkan lingkup peternakan (farm-scoped), yang berarti hanya satu peternakan yang diekspos ke client yang terhubung dalam satu waktu.
Untuk menggunakan server ini, Anda memerlukan Node.js 22 atau terbaru dan akun Ranch.Bot dengan akses peternakan. Setup melibatkan instalasi package melalui npm dan penggunaan command ranchbot-mcp login untuk autentikasi melalui browser, sehingga Anda tidak perlu memasukkan API key secara manual. Setelah dikonfigurasi, AI client dapat menggunakan tool seperti list_animals dan list_records untuk mengambil inventaris atau mengelola riwayat.
Penulisan data memerlukan peran dan izin tertentu. Meskipun Reader dapat melakukan pencarian data, Editor dan Owner dapat membuat pembaruan atau mengonfirmasi kelahiran. Server ini mendukung workflow yang kompleks, seperti menggunakan preview_birth_event dan confirm_birth_event untuk memastikan akurasi data sebelum menyimpan perubahan ke catatan peternakan.
Apa yang bisa Anda lakukan dengannya
- 1Merangkum inventaris peternakanMinta AI untuk memberikan ringkasan lengkap mengenai populasi hewan saat ini di peternakan tertentu.
- 2Rekonsiliasi catatan ternak yang terpisahGunakan asisten untuk membandingkan spreadsheet, catatan, dan PDF dengan catatan resmi peternakan.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Ranch.Bot MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal Ranch.Bot MCP di Claude Code
$ claude mcp add mcp-server -- npx -y @ranchbot/mcp-serverInstal Ranch.Bot MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@ranchbot/mcp-server"
]
}
}
}Instal Ranch.Bot MCP di VS Code
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ranchbot/mcp-server"
]
}
}
}Instal Ranch.Bot MCP di VS Code CLI
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@ranchbot/mcp-server"]}'Instal Ranch.Bot MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@ranchbot/mcp-server"
]
}
}
}Instal Ranch.Bot MCP di Codex
$ codex mcp add mcp-server -- npx -y @ranchbot/mcp-serverInstal Ranch.Bot MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@ranchbot/mcp-server"]
Instal Ranch.Bot MCP di Gemini CLI
$ gemini mcp add -s user mcp-server npx -- -y @ranchbot/mcp-serverInstal Ranch.Bot MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@ranchbot/mcp-server"
]
}
}
}Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauranchbot/mcp-server is public and reachablegithub.com/ranchbot/mcp-server ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernya@ranchbot/mcp-server names ranchbot/mcp-server as sourcenpmjs.com/package/@ranchbot/mcp-server ↗Lolos
- Provenance build (atestasi Sigstore)Sigstore attestation for @ranchbot/mcp-servernpmjs.com/package/@ranchbot/mcp-server/v/0.2.0#provenance ↗Lolos
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-10-20github.com/ranchbot/mcp-server ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from @ranchbot/mcp-serverLolos
- Tidak ada advisory kritis pada paket atau dependensinya119 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubRanch.Bot MCP Server
Read and write cattle and sheep records through a local MCP server on your own computer. It uses your Ranch.Bot account over the stdio transport and exposes one farm at a time. Hosted connections are not public yet. ChatGPT access is a private pilot. Ranch.Bot’s Claude connector is in review; you can still connect it privately as a custom connector.
Requirements: Node.js 22 or newer, a Ranch.Bot account, and access to a farm.
Install and sign in
These commands install this source package's version (0.2.0). For the recommended public release, use the pinned command on MCP setup, the source of truth for setup; release status and promotion rules live in MAINTAINING.md. Stop older CLI and MCP processes before upgrading; never remove their active lock files.
npm install -g @ranchbot/mcp-server@0.2.0
ranchbot-mcp --version
ranchbot-mcp login
Open the printed URL, sign in, and explicitly approve the displayed code and requested access in
your browser. No API key is needed. If login expires, run ranchbot-mcp login again; sign out with
ranchbot-mcp logout. See
Troubleshooting for
access-denied and session problems, and keep passwords and token files out of assistant messages.
Configure a local stdio client
Point an MCP client at the installed command with no arguments:
{
"mcpServers": {
"ranchbot": { "command": "ranchbot-mcp", "args": [] }
}
}
If the client cannot find the command, use its absolute executable path. Restart the client after
changing configuration. ranchbot-mcp --help and ranchbot-mcp --version work without
authentication. Any MCP client that can run a local stdio server works; this is not a certification
of any named client.
First successful read
Ask the client to call these tools in order:
list_my_farmswith{}. Choose the intended farm ID. If more than one farm is plausible and the producer did not name one, ask instead of guessing.list_animalswith{"farm_id":"<farm_id>"}, replacing the placeholder with that ID.
An empty list is a successful read. Pass farm_id explicitly on every scoped call; setting a
default with set_default_farm is optional. If access is denied, check the account and farm
membership; missing authentication means terminal login, then retry. Tool calls never start browser
approval. A different account clears the process's default farm.
list_animals accepts query, match_mode (exact default, or partial) and
identifier_type; exact matches saved identifiers and the current profile name, partial is literal
substring discovery over profile names and NAME/MANAGEMENT_TAG identifiers. list_records
accepts animal_id, group_id, include_group_context and explicit inclusive/exclusive
applied_from/applied_before RFC3339 bounds; the first three and the bounds activate bounded
history mode. Scoped credentials need the matching extra read scope for a target filter.
A useful read-only task: "Summarize the selected farm's current inventory." Read the complete
relevant population, follow each operation's pagination (skip/take) and returned total, and
report incomplete retrieval rather than presenting a first page as the whole answer.
Writing farm data
Ordinary writes save directly under your server permissions, without the app confirmation screen or its Change History. Before any mutation, present the operation, farm, resolved targets, exact values, and consequences and get explicit approval. Read the result back afterwards. If the outcome is uncertain, reconcile with reads before proposing another write.
Roles and scopes both apply: Readers can read, including the safe lookup_animal_by_eid; Editors or
Owners can create and update and confirm a birth; deleting animals, groups, records, or identifiers
needs Owner access. Birth confirmation also needs the write:records, write:animals, and
write:groups scopes. A missing scope and a missing role are separate problems.
Direct births use preview_birth_event → approval → confirm_birth_event. Saved amendments and
entered-in-error use preview_workflow with operation: "amend_birth", the record revision and a
reason, then exact approval and commit_workflow, when exposed by the connected release. Never
re-record a birth as a correction; if capability is missing, stop and contact
support. Read the
birth events reference before handling births.
Farms can configure a versioned record_birth template that drives the shared
preview_workflow → approval → commit_workflow flow. The list_workflow_templates,
get_workflow_template, create_workflow_template, publish_workflow_template_version,
update_workflow_template_state, and set_default_workflow_template tools manage that
configuration (Owner writes with write:farms). After upgrading from a login that lacks
write:farms, run ranchbot-mcp login and approve a fresh authorization. Refresh preserves the
existing grant; it cannot add scopes. A new grant does not elevate your farm role.
Commit requires the exact preview_hash read back from a fresh
preview; a stale hash is rejected. Templates change
labels, visibility, defaults, and custom observations only — the meaning and review controls of
core birth fields do not change. See the workflow guide for the run and
configuration steps.
Agent skill
The package ships the public Agent Skill bundle at skills/ranchbot (SKILL.md plus
references/). It is optional guidance, not a capability or a security boundary; installation
details are in the MCP reference.
Task references
- MCP reference — connection, tool discovery, farm context, errors, and optional skill installation.
- Birth events reference — preview, confirmation, retry, saved amendments, and capability limits.
- Exports reference — archive create, poll, cancel, and download.
- Mixed-source reconciliation — historical imports, coverage ledgers, and lender-document caveats.
Jobs for an external assistant
A producer can authorize a local assistant to reconcile years of lambing spreadsheets, iPhone notes, messages, and livestock PDFs against one farm, produce custom reports, or compare farm history with an authorized lender or AgriStability snapshot for the same population and date. Totals are aggregate evidence, not individual animals or proof of current group membership; this is livestock reconciliation, not financial advice. Follow the mixed-source reconciliation recipe and the workflow pagination rules; MCP does not persist the coverage ledger.
Package guides
- Workflows — find an animal, save an ordinary record, and preview and confirm a birth, with inputs, pagination, and recovery.
- Architecture — the request path and which component enforces each guarantee.
- Troubleshooting — login, farm selection, lock, and access problems.
- Development — credential-free checks, the authenticated development server, and packaging.
- Contributing — how changes reach this exported repository and where to send feedback.
- Security — how to report a vulnerability privately.
Maintainer instructions
See MAINTAINING.md for development, admin login, local installations, EID migration, authentication troubleshooting, and detailed credential-lock recovery. For shell commands, use CLI setup. For everyday record entry, use SMS and web setup. Support: support@ranch.bot.
License
MIT. See LICENSE.
Pertanyaan tentang Ranch.Bot MCP
Bagaimana cara menambahkan Ranch.Bot MCP ke Claude Code?
Jalankan claude mcp add mcp-server -- npx -y @ranchbot/mcp-server di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Ranch.Bot MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Bagaimana cara login ke Ranch.Bot MCP server?
Jalankan command ranchbot-mcp login, buka URL yang muncul di browser Anda, dan setujui akses yang diminta.
Apakah saya memerlukan API key untuk menggunakan server ini?
Tidak, API key tidak diperlukan untuk autentikasi.
Apa saja persyaratan sistem untuk instalasi?
Anda memerlukan Node.js versi 22 atau terbaru, akun Ranch.Bot, dan akses ke sebuah peternakan.
Bisakah saya menggunakannya dengan ChatGPT?
Akses ChatGPT saat ini masih dalam tahap private pilot.