You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
104 lines
2.4 KiB
104 lines
2.4 KiB
# Second Brain MCP Server
|
|
|
|
MCP server to interact with your Second Brain knowledge management system from any MCP-compatible client (Claude Desktop, VS Code, etc.).
|
|
|
|
## Features
|
|
|
|
- **add_log** - Add quick notes/log entries with timestamps
|
|
- **add_document** - Create new markdown documents directly
|
|
- **upload_document** - Upload files (.md, .txt, .pdf, .json, .yaml, .csv)
|
|
- **search** - Semantic search across your knowledge base
|
|
- **chat** - Chat with AI using RAG on your documents
|
|
- **list_logs** / **get_log** - Browse daily logs
|
|
- **list_documents** - Browse vault contents
|
|
- **get_stats** - Knowledge base statistics
|
|
- **reindex** - Trigger vault reindexing
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
# Clone or copy this folder to your local machine
|
|
cd second-brain-mcp
|
|
|
|
# Install dependencies
|
|
npm install
|
|
|
|
# Build
|
|
npm run build
|
|
```
|
|
|
|
## Configuration
|
|
|
|
Set environment variables:
|
|
|
|
```bash
|
|
# Required: Your Second Brain API URL
|
|
export SECOND_BRAIN_API_URL="https://2brain.coer.nl/api"
|
|
|
|
# Optional: Basic auth credentials (if using access list)
|
|
export SECOND_BRAIN_USERNAME="your-username"
|
|
export SECOND_BRAIN_PASSWORD="your-password"
|
|
```
|
|
|
|
## Usage with Claude Desktop
|
|
|
|
Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on Mac or `%APPDATA%\Claude\claude_desktop_config.json` on Windows):
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"second-brain": {
|
|
"command": "node",
|
|
"args": ["/path/to/second-brain-mcp/dist/index.js"],
|
|
"env": {
|
|
"SECOND_BRAIN_API_URL": "https://2brain.coer.nl/api",
|
|
"SECOND_BRAIN_USERNAME": "your-username",
|
|
"SECOND_BRAIN_PASSWORD": "your-password"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Usage with VS Code (Copilot)
|
|
|
|
Add to your VS Code settings:
|
|
|
|
```json
|
|
{
|
|
"github.copilot.chat.mcpServers": {
|
|
"second-brain": {
|
|
"command": "node",
|
|
"args": ["/path/to/second-brain-mcp/dist/index.js"],
|
|
"env": {
|
|
"SECOND_BRAIN_API_URL": "https://2brain.coer.nl/api"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Example Usage
|
|
|
|
Once configured, you can use natural language:
|
|
|
|
- "Add a note about the meeting with John today"
|
|
- "Search my knowledge base for homelab documentation"
|
|
- "What do I know about Proxmox configuration?"
|
|
- "Upload this requirements.txt file to my second brain"
|
|
- "Show me my recent logs"
|
|
|
|
## Development
|
|
|
|
```bash
|
|
# Run in development mode
|
|
npm run dev
|
|
|
|
# Build for production
|
|
npm run build
|
|
```
|
|
|
|
## License
|
|
|
|
MIT
|