About Second Brain MCP
Second Brain MCP is an MCP server published by RyanMaxiemus in the Developer Tools category: mCP server that indexes your codebase with semantic search. Ask "find the auth bug I was debugging" instead of grepping. Uses embeddings + SQLite for local vector search. Respects .gitignore, tracks file changes, answers "what did I work on last week?".
The repository has 2 stars and 0 forks, with the last commit 8 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
uvx mcp-second-brainpip install mcp-second-brainThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Second Brain MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 9 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- !Dependencies pinnedNo lockfile. Installs can pull different code over time.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
🧠 Second Brain MCP
Your code, but searchable like memories. Stop grepping, start remembering. A semantic search MCP server for your codebase—ask natural questions, get smart answers.
TL;DR
Second Brain MCP is a local server that indexes your code and other text-based files, allowing you to perform semantic searches using natural language. It runs as a Model Context Protocol (MCP) server, so you can interact with it from any MCP-compatible client. It uses OpenAI's embedding models to understand the meaning of your code, not just keywords.
🛠️ Tech Stack
This project is a TypeScript-based Node.js application.
| Component | Technology | Key Libraries/Frameworks |
|---|---|---|
| Application Runtime | Node.js | TypeScript, @modelcontextprotocol/sdk |
| Database | SQLite | better-sqlite3 |
| Embeddings | OpenAI | openai |
| Development | Package Manager | npm |
🚀 Quick Start
The following instructions are optimized for a Linux environment (Ubuntu/Debian).
Prerequisites
You must have Node.js (v20+) and npm installed.
-
Clone the repository
git clone https://github.com/RyanMaxiemus/second-brain-mcp.git cd second-brain-mcp -
Configure Environment Variables
You will need an OpenAI API key. You can set it as an environment variable:
export OPENAI_API_KEY="YOUR_OPENAI_API_KEY" -
Install Dependencies
Install all necessary Node.js dependencies.
npm install -
Build the Application
Compile the TypeScript code to JavaScript.
npm run build -
Run the Application
Launch the MCP server.
npm startThe server will be running and ready to accept connections from an MCP client.
🤝 Contributing
Found a bug? Have an idea for a new feature? We welcome all contributions!
- Open an Issue: Before submitting a Pull Request, please open an issue to discuss the bug or feature you're working on. This helps prevent duplicate work and ensures alignment with the project's goals.
- Fork and Branch: Fork the repository and create a new branch for your contribution.
- Code and Commit: Write clean, well-documented code. Commit messages should be descriptive and follow a conventional format (e.g.,
feat: add support for local embeddings). - Submit a PR: Submit a Pull Request against the
mainbranch. We'll review it as quickly as possible.
Let's make Second Brain the most intuitive code search tool available, together.
README fetched from the repository 9 days ago. The original is authoritative.