About Sippion
Sippion is a local, read-only MCP server that retrieves a small set of relevant repository excerpts for coding agents, reducing unnecessary context. Retrieval stays offline, does not execute repository code, and keeps no persistent index.
Key features
- 01Single repository-context retrieval tool
- 02Lexical, structural, and semantic retrieval
- 03Local and read-only operation
- 04Redaction of high-confidence secrets
- 05Retrieval state kept in memory only
- 06Structural parsing for multiple languages
Use cases
- 01Find relevant source excerpts from a query
- 02Supply focused repository context for coding tasks
- 03Search a repository without running its code
- 04Reduce the need to read large files
MCP support
Sippion is a local MCP server that provides bounded repository-context retrieval to coding agents through the repo_context tool.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMESippion
English | 日本語
Use less AI context. Make API tokens — and subscription usage allowances — last longer.
Sippion is a local, read-only MCP server that helps AI coding agents consume fewer tokens. Instead of letting an agent open large parts of a repository, Sippion's single tool, repo_context, returns a small set of relevant, bounded source excerpts first.
This reduces unnecessary context per task. It can lower usage for API-based workflows, but that is not the only benefit: Sippion can also help subscription-based AI coding plans last longer by reducing how much context the agent needs to consume.
How it works
AI coding agent
↓ ask for focused repository context
Sippion repo_context
↓ return a few relevant excerpts
AI reads only the files it actually needs
Example:
repo_context {"q":"authentication token validation"}
Sippion uses bounded lexical, structural, and semantic retrieval while staying local and read-only.
Install
macOS / Linux
curl -fsSL --proto '=https' --proto-redir '=https' --tlsv1.2 https://raw.githubusercontent.com/Sitten-Tokyo/Sippion/75d6b27e83b86bec00297cd5b5c05bb014e16904/scripts/bootstrap.sh | sh
Windows PowerShell
irm https://raw.githubusercontent.com/Sitten-Tokyo/Sippion/75d6b27e83b86bec00297cd5b5c05bb014e16904/scripts/bootstrap.ps1 | iex
Then restart your AI client. sippion setup registers Sippion for Codex, Claude Code, Antigravity, and OpenCode.
Useful commands:
sippion setup
sippion doctor
sippion uninstall
sippion mcp --root-auto
Why Sippion
- Fewer tokens: gives the agent focused repository context instead of broad file reads.
- Useful beyond API billing: can help subscription usage allowances last longer too.
- Local and private: no network access while serving repository context.
- Read-only: never modifies the repository or executes repository code.
- No persistent index: retrieval state stays in RAM.
- Small surface area: one MCP tool,
repo_context.
Sippion is a repository-context tool, not a compiler or language server. Structural parsing currently covers Rust, Python, JavaScript/TypeScript, Go, Java, C#, C, and C++.
Safety
Sippion does not run repository code, build scripts, compilers, LSP servers, or shell commands during retrieval. Repository text is treated as untrusted data, and high-confidence secrets are redacted before model output.
See Security and trust boundary for details.
Documentation
- Client setup
- Architecture
- Security and trust boundary
- Efficiency layer
- Quality and validation
- Contributing
Credits
The compact efficiency behavior is inspired by Ponytail and i-have-adhd. License notes are in Third-party notices.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.