idea-basin-mcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@idea-basin-mcpsearch my knowledge base for AI ethics"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
idea-basin-mcp
MCP server for Idea Basin — a semantic knowledge graph with vector search, hierarchical organization, and automatic content ingestion.
Gives Claude (and any MCP-compatible AI assistant) the ability to search, browse, and save to your personal knowledge base.
How it works
flowchart LR
subgraph client["AI Assistant"]
Claude["Claude / Any MCP Client"]
end
subgraph mcp["idea-basin-mcp"]
direction TB
T1["search_knowledge"]
T2["browse_nodes"]
T3["get_node"]
T4["save_resource"]
T5["fetch_and_save"]
end
subgraph basin["Idea Basin Server :3500"]
API["REST API"]
Embed["Embedder"]
Scraper["Scraper"]
end
subgraph storage["Storage"]
PG[("PostgreSQL + pgvector")]
end
Claude -- "stdio / JSON-RPC" --> mcp
mcp -- "HTTP" --> API
API --> Embed
API --> Scraper
API --> PGTools
Tool | Description |
| Semantic similarity search across all knowledge chunks |
| Browse the knowledge graph tree structure (3 levels deep) |
| Inspect a node with its children and resources |
| Save a note, research, link, code, or idea to a node |
| Fetch a URL (web page, YouTube, GitHub, arXiv, PDF) and save it |
Prerequisites
A running Idea Basin server (default: http://localhost:3500).
Install
Claude Code
claude mcp add idea-basin -- node /path/to/idea-basin-mcp/build/index.jsOr with a custom Basin URL:
claude mcp add idea-basin -e IDEA_BASIN_URL=http://localhost:3500 -- node /path/to/idea-basin-mcp/build/index.jsClaude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"idea-basin": {
"command": "node",
"args": ["/path/to/idea-basin-mcp/build/index.js"],
"env": {
"IDEA_BASIN_URL": "http://localhost:3500"
}
}
}
}npm (once published)
npx idea-basin-mcpConfiguration
Env var | Default | Description |
|
| Base URL of your Idea Basin server |
Development
npm install
npm run build # TypeScript → build/
npm run dev # Watch modeLicense
MIT
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/MsFixer101/idea-basin-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server