Binder MCP server
2026년 10월 20일 커밋AI agent이 MCP를 통해 로컬 Markdown 동기화 지식 베이스 내의 타입 지정 엔티티를 조회, 생성 및 업데이트할 수 있습니다.
다른 이름 mpazik/Binder
- 스타
- 40
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 10월 20일
- 라이선스
- MIT
Binder MCP란?
AI agent이 MCP를 통해 로컬 Markdown 동기화 지식 베이스 내의 타입 지정 엔티티를 조회, 생성 및 업데이트할 수 있습니다.
프로젝트 README에서 생성된 요약
Binder MCP server 정보
Binder는 로컬 우선 방식의 Markdown 동기화 지식 베이스를 통해 AI agent 및 자동화 파이프라인을 위한 구조화된 데이터 관리를 지원합니다. 개발자는 YAML 스키마를 사용하여 Task, Contact, Decision과 같은 타입 지정 엔티티를 정의할 수 있으며, 이를 통해 agent가 상태를 공유하는 데 사용할 수 있는 지속적인 메모리 계층을 생성합니다. 이 시스템은 엔티티 그래프로 작동하며 모든 변경 사항은 불변 트랜잭션으로 기록되어 전체 감사 추적을 제공하고 이력을 되돌리거나 재생할 수 있습니다.
사용자는 CLI, VS Code, WebStorm 또는 Neovim용 에디터 확장 프로그램, 그리고 직접적인 AI 통합을 위한 MCP server를 포함한 다양한 인터페이스를 통해 데이터와 상호작용합니다. 웹 기반 워크플로우의 경우 binder http 명령으로 로컬 API와 레코드 브라우저를 실행할 수 있습니다. 이 설정은 전체 SaaS 애플리케이션 없이도 소규모 운영 도구, 리드 분류를 위한 인박스 또는 연구용 레지스트리를 구축하는 데 이상적입니다.
활용 사례
- 1자동화된 작업 추적AI agent가 MCP를 통해 작업 상태를 생성하고 업데이트함으로써 프로젝트 파이프라인을 관리할 수 있습니다.
- 2agent 메모리 유지개발자는 서로 다른 AI 도구들이 지속적인 컨텍스트를 공유할 수 있도록 구조화된 방법을 제공할 수 있습니다.
- 3커스텀 관리 패널 구축로컬 JSON API를 호스팅하여 로컬 레코드를 관리하기 위한 커스텀 대시보드를 구축할 수 있습니다.
- 4동기화된 데이터 편집에디터에서 Markdown 파일을 수동으로 편집하면 기반 데이터베이스가 자동으로 업데이트됩니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능mpazik/binder is public and reachablegithub.com/mpazik/binder ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-20github.com/mpazik/binder ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기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 질문
MCP를 통해 AI agent를 Binder에 연결하려면 어떻게 하나요?
.mcp.json에 type은 stdio, command는 binder mcp로 설정된 binder 항목을 추가합니다. 그러면 agent가 타입 지정 읽기/쓰기 API를 통해 엔티티를 조회, 생성 및 업데이트할 수 있습니다.
명령줄에서 레코드를 조회하려면 어떻게 하나요?
type 및 status와 같은 필터를 사용하여 binder search를 실행하며, 선택적으로 필드를 지정할 수 있습니다. 출력 결과는 jq와 같은 도구로 JSON 파이프 전달이 가능합니다.
Binder가 HTTP API를 제공할 수 있나요?
네, binder http를 실행하면 JSON API와 레코드 브라우저를 포함한 로컬 서버가 시작되며, server.ts 파일을 통해 커스텀 라우트를 추가할 수 있습니다.