
spranab/saga-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
에이전트는 세션 사이의 계획을 잃습니다. 그래서 saga-mcp는 프로젝트, epics, 작업, subtasks, Dependencies 및 노트에 대한 SQLite-backed 추적기를 제공합니다. 33 MCP 도구, 활동 로그 및 하나의 호출 ...
개요
코딩 에이전트는 세션 간의 계획을 잃습니다. 당신은 내일 다시 와서 당신이 동의 한 다섯 가지의 아이디어가 없습니다, 어느 쪽이 차단되는, 또는 왜 두 번째 접근을 거부 - 계획이 컨텍스트 창에 살기 때문에, 또는 TODO.md 아무도 업데이트. saga-mcp는 대신 실제 추적기를 제공합니다 : 프로젝트 보유 프로젝트의 SQLite 파일, epics, 작업, subtasks, Dependencies, 코멘트, 노트 및 결정, 33 MCP 도구로 노출. 에이전트는 작동하고 다시 올 때 대시보드를 읽습니다. 계정 없음, 외부 서비스 없음, 네트워크 통화 없음 - 데이터베이스는 당신이 소유 한 파일입니다. Claude Code — 프로젝트의 .mcp.json에 추가: 클라이언트를 재시작. DB PATH는 유일한 조정입니다; 파일 및 스키마는 첫번째 사용에 창조됩니다. "전자 상거래 API에 대한 추적을 설정하고 우위를 계획하십시오." 작업 2 및 3 다시 온다 — 그들의 의존은 수행되지 않습니다. 완료 작업 1 및 작업 2 자체 차단.
개요(AI 번역)
코딩 에이전트는 세션 간의 계획을 잃습니다. 당신은 내일 다시 와서 그것은 아무 생각도 없다
당신이 동의 한 다섯 가지의 것들은, 어느 쪽이 차단되는, 또는 왜 당신이 거부
두 번째 접근법 - 계획이 컨텍스트 창에서 살았기 때문에, 또는 TODO.md 아무도 업데이트.
saga-mcp는 대신 실제 추적기를 제공합니다 : 프로젝트 보유 프로젝트의 SQLite 파일, 서사시, 작업, subtasks, Dependencies, 코멘트, 노트 및 결정, 41 MCP 도구로 노출. 더 보기 대리인은 그것을 작동하고 돌려보낼 때 그것을 돌려보냅니다. 계정 없음, 외부 서비스 없음, 네트워크 호출 없음 - 데이터베이스는 당신이 소유 한 파일입니다.
설치
MCP 클라이언트에 saga-mcp를 추가하십시오. 같은 블록은 Claude Code (.mcp.json에 대한 작동
프로젝트), Claude 데스크탑 ([T2]]) 및 기타 MCP 클라이언트 :
클라이언트를 재시작합니다. DB_PATH는 필요한 설정입니다. 파일과 스키마가 생성됩니다.
첫번째 사용. 글로벌 설치 예시? npm install -g saga-mcp, 다음 명령으로 saga-mcp를 사용한다.
대신 npx.
Linux, macOS 및 Windows에서 Node 20, 22 및 24에 테스트되었습니다.
설정
| 변하기 쉬운 | Required | 묘사 |
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
saga-mcp
Your coding agent loses the plan between sessions. You come back tomorrow and it has no idea which
of the five things you agreed on are done, which one is blocked on which, or why you rejected the
second approach — because the plan lived in the context window, or in a TODO.md nobody updates.
saga-mcp gives the agent a real tracker instead: a SQLite file in your project holding projects, epics, tasks, subtasks, dependencies, comments, notes and decisions, exposed as 41 MCP tools. The agent writes to it as it works and reads it back when it returns. No accounts, no external service, no network calls — the database is a file you own.
Install
Add saga-mcp to your MCP client. The same block works for Claude Code (.mcp.json in your
project), Claude Desktop (claude_desktop_config.json), and any other MCP client:
{
"mcpServers": {
"saga": {
"command": "npx",
"args": ["-y", "saga-mcp"],
"env": { "DB_PATH": "/absolute/path/to/your/project/.tracker.db" }
}
}
}
Restart the client. DB_PATH is the only required setting; the file and its schema are created on
first use. Prefer a global install? npm install -g saga-mcp, then use saga-mcp as the command
instead of npx.
Tested on Node 20, 22 and 24, on Linux, macOS and Windows.
Settings
| Variable | Required | Description |
|---|---|---|
DB_PATH |
Yes | Path to the .tracker.db SQLite file. Created on first use. |
SAGA_PROJECT |
No | Scope every tool to one project, by id or name. Set this per repo when several repos share one database. |
SAGA_DESCRIPTION_LOCK |
No | on_progress locks a task’s description the moment work starts on it. Off by default. See keeping agents on the rails. |
SAGA_TOOLS |
No | full (default) lists all 41 tools. core lists only the 13 an ordinary tracking session needs, saving ~4,300 tokens per session. See token cost. |
No API keys, no accounts, no external services.
Your first session
You: “Set up tracking for the e-commerce API and plan out auth.”
tracker_init({ project_name: "E-Commerce API" })
epic_create({ project_id: 1, name: "Authentication", priority: "high" })
task_create({ epic_id: 1, title: "Design auth schema", priority: "critical" })
task_create({ epic_id: 1, title: "Implement JWT auth", depends_on: [1] })
task_create({ epic_id: 1, title: "Add OAuth2 Google login", depends_on: [2] })
설치
npx -y saga-mcp설정
{
"mcpServers": {
"saga": {
"command": "npx",
"args": ["-y", "saga-mcp"],
"env": { "DB_PATH": "/absolute/path/to/your/project/.tracker.db" }
}
}
}