Binder MCP sunucusu
Commit 20 Eki 2026AI agent'larının MCP aracılığıyla yerel, Markdown ile senkronize bir bilgi tabanında tiplendirilmiş varlıkları sorgulamasını, oluşturmasını ve güncellemesini sağlar.
Ayrıca bilinen adı mpazik/Binder
- Yıldızlar
- 40
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 20 Eki 2026
- Lisans
- MIT
Binder MCP nedir?
AI agent'larının MCP aracılığıyla yerel, Markdown ile senkronize bir bilgi tabanında tiplendirilmiş varlıkları sorgulamasını, oluşturmasını ve güncellemesini sağlar.
Özet, projenin README dosyasından oluşturuldu
Binder MCP sunucusu hakkında
Binder, yerel öncelikli ve Markdown ile senkronize bir bilgi tabanı aracılığıyla AI agent'ları ve otomasyon süreçleri için yapılandırılmış verilerin yönetilmesini sağlar. Geliştiricilerin Görevler, Kişiler veya Kararlar gibi tiplendirilmiş varlıkları bir YAML şeması kullanarak tanımlamasına olanak tanır ve agent'ların durum paylaşmak için kullanabileceği kalıcı bir bellek katmanı oluşturur. Sistem, her değişikliğin değiştirilemez bir işlem olarak kaydedildiği bir varlık grafiği gibi çalışarak tam bir denetim izi ve geçmişi geri alma veya yeniden oynatma imkanı sunar.
Kullanıcılar verileriyle; CLI, VS Code, WebStorm veya Neovim için editör eklentileri ve doğrudan AI entegrasyonu için bir MCP server dahil olmak üzere birden fazla arayüz üzerinden etkileşime girer. Web tabanlı iş akışları için binder http komutu yerel bir API ve kayıt tarayıcısı başlatır. Bu kurulum; tam teşekküllü bir SaaS uygulamasına ihtiyaç duymadan küçük operasyon araçları, potansiyel müşteri ayrıştırma kutuları veya araştırma kayıtları oluşturmak için idealdir.
Neler yapabilirsiniz
- 1Otomatik görev takibiBir AI agent, MCP aracılığıyla görev durumlarını oluşturup güncelleyerek bir proje sürecini yönetebilir.
- 2Agent belleğini korumaGeliştiriciler, farklı AI araçlarının kalıcı bağlam paylaşması için yapılandırılmış bir yöntem sağlayabilir.
- 3Özel yönetim panelleri oluşturmaYerel kayıtlarınızı yönetmek için özel dashboard'lar oluşturmak üzere yerel bir JSON API barındırabilirsiniz.
- 4Senkronize veri düzenlemeBir editörde Markdown dosyalarını manuel olarak düzenlemek, alttaki veritabanını otomatik olarak güncelleyecektir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirmpazik/binder is public and reachablegithub.com/mpazik/binder ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-20github.com/mpazik/binder ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
Binder
The database for tools you build with AI
Local-first, accessible from your editor, scripts, agents, and browser.
What it's for • Getting Started • How it works • Features • Working with Binder • Roadmap
What it's for
Binder is a perfect storage for all sorts of tools and automation built with agents. It especially excels when you need programmatic access and agent or human in the loop. Things like:
- Trackers and pipelines task tracking, hiring or sales. Binder holds the schema for stages, organizes files by status, and logs every change.
- Inboxes and queues of stuff to triage. Support tickets, leads, things an agent works through. Agents read and write over MCP or CLI. Scripts batch-process. Mistakes undo cleanly.
- Catalogs and registries you look things up in: vendors, subscriptions, research, contacts. Records are typed and link to each other. Query from the CLI. Autocomplete in the editor.
- Dashboards and admin panels for small ops tools that don't justify a SaaS or a full app.
binder httpgives you an API and a record browser. Drop inserver.tsfor your own routes. - Agent context and memory so your AI tools have somewhere typed and persistent to share state among themselves and people. Structured, fully transparent and easy to maintain.
Getting Started
1. Install Binder
npm install -g @binder.do/cli
bun install -g @binder.do/cli
2. Set up a workspace
binder init
The setup wizard will prompt you to pick a blueprint: a starter schema for common use cases like project management or personal notes.
3. Editor extension
Adds autocomplete for field names and valid values, inline validation, and syncs file edits back to the database on save.
- VS Code: install the Binder extension. Activates automatically in any Binder workspace.
Install the Binder plugin. Activates automatically in any Binder workspace.
require('lspconfig').configs.binder = {
default_config = {
cmd = { 'binder', 'lsp' },
filetypes = { 'markdown', 'yaml' },
root_dir = require('lspconfig.util').root_pattern('.binder'),
},
}
require('lspconfig').binder.setup({})
How it works
Binder stores your data as a graph of entities: each one a flexible collection of field-value pairs classified by a type like Task, Decision, or Contact. Fields are defined once and reused across types. References link entities directly, forming the graph. Types and fields are defined in .binder/types.yaml:
items:
- key: Task
fields:
- title: { required: true }
- status: { only: [pending, active, complete] }
- priority
- partOf: { only: [Milestone] }
- requires: { only: [Task] }
Editors, scripts, and agents all write to the same data. When something goes wrong, you need to know what changed and undo it. Binder records every change as an immutable transaction, attributed to its source. Full history, undo and redo, replay to any past state.
Markdown files are a view over this graph. Navigation rules define where each entity lives on disk. Change a field value and Binder moves the file automatically:
items:
- where: { type: Task, status: { op: in, value: [pending, active] } }
path: tasks/{priority} {key}
- where: { type: Task, status: complete }
path: archive/tasks/{key}
Features
Working with Binder
Same data, different surfaces. Use whichever fits the task.
Editors
Open any Markdown file in your coding editor to read, adjust, and review. Binder's LSP provides validation, autocomplete, and navigation across all entity files.
Install the VS Code extension to get started, or see Getting Started for WebStorm/IntelliJ and Neovim setup.
AI Agents
For autonomous work: querying context, capturing decisions, writing new entities. Agents can use the CLI directly or connect via MCP for a typed read/write API.
Add to .mcp.json to enable MCP:
{
"mcpServers": {
"binder": {
"type": "stdio",
"command": "binder",
"args": ["mcp"]
}
}
}
Scripts and Automation
For pipelines, batch operations, reports, or embedding Binder in your own apps and libraries. Query, create, and update records without parsing Markdown. Changes write back to files automatically.
$ binder search type=Task status=active -f "title,status,priority,partOf(title,status)"
items:
- title: Add dark mode support
status: active
priority: p2
partOf:
title: MVP Release
status: active
Pipe to any tool:
$ binder search type=Task status=active -q | jq '.items[] | .key + ": " + .title'
"setup-auth: Set up authentication"
"fix-layout-bug: Fix layout orientation bug"
Create and update without opening a file:
$ binder create Task dark-mode title="Add dark mode support" status=active priority=p2 partOf=mvp-release
$ binder update dark-mode status=complete
Embed Binder directly. Use it in a one-off script, a long-running service, a library, or any Node/Bun app:
import { open, isErr } from "@binder/repo/local";
const repo = await open("/path/to/workspace"); // omit to run from cwd
if (isErr(repo)) throw repo.error;
const { data: kg } = repo;
const r = await kg.search({ filters: { type: "Task", status: "complete" } });
if (!isErr(r)) for (const t of r.data.items) console.log("-", t.title);
await kg.close();
Workspace scripts. As a convenience, files in .binder/scripts/ (.ts, .js, .mjs, .sh) become first-class subcommands:
$ binder weekly-report # runs .binder/scripts/weekly-report.ts
$ binder run weekly-report # equivalent, never shadowed by built-ins
HTTP
For browser UIs, webhooks, and integrations. binder http starts a local server with a record browser at http://127.0.0.1:4000, plus a JSON API:
GET /api/schema- types and fieldsGET /api/records?type=Task&status=active- query recordsGET /api/records/:key- fetch onePOST /api/transactions- apply a transaction
Bring your own UI with --static <dir>, or drop one at .binder/web/ for zero config. The built-in record browser is the fallback.
Drop a server.ts next to your static files to add custom routes, built on Hono. Source files aren't served.
import { Hono } from "hono";
import type { ServerModule } from "@binder.do/cli";
const mod: ServerModule = ({ kg }) => {
const app = new Hono();
app.get("/api/stats", async (c) => {
const r = await kg.search({ filters: { type: "Task" } });
return c.json({ tasks: "data" in r ? r.data.length : 0 });
});
return app;
};
export default mod;
→ See HTTP server docs for the full reference.
Hooks
Run a shell command on every committed transaction. The transaction is piped to stdin as JSON. Declare them in .binder/config.yaml:
hooks:
- name: notify-slack
command: ./scripts/notify-slack.sh
- name: audit
command: jq -c . >> .binder/audit.log
Roadmap
Next
- More blueprints and examples
- Full-text and semantic search
- Transaction log compaction
Future
- Cross-device synchronisation
- E2E encrypted backup
- Encrypted fields
- Web / Mobile UI
Contributing
Binder is early-stage and actively shaped by feedback. Found a bug or have an idea? Open an issue. All input welcome.
License
Binder MCP soruları
Bir AI agent'ını MCP üzerinden Binder'a nasıl bağlarım?
.mcp.json dosyanıza type stdio ve binder mcp komutuyla bir binder girişi ekleyin. Agent'lar daha sonra tiplendirilmiş bir okuma/yazma API'si aracılığıyla varlıkları sorgulayabilir, oluşturabilir ve güncelleyebilir.
Komut satırından kayıtları nasıl sorgularım?
type ve status gibi filtrelerle birlikte binder search komutunu kullanın; isteğe bağlı olarak alan seçimi yapabilirsiniz. Çıktı, jq gibi araçlara JSON olarak pipe edilebilir.
Binder bir HTTP API sunabilir mi?
Evet, binder http komutu JSON API ve kayıt tarayıcısı içeren yerel bir sunucu başlatır; ayrıca bir server.ts dosyası ile özel rotalar ekleyebilirsiniz.