98a1b79293
<!-- .github/pull_request_template.md --> ## Description Resolve issue with .venv being broken when using docker compose with Cognee ## DCO Affirmation I affirm that all code in every commit of this pull request conforms to the terms of the Topoteretes Developer Certificate of Origin. --------- Co-authored-by: Boris Arzentar <borisarzentar@gmail.com>
105 lines
2.2 KiB
Markdown
105 lines
2.2 KiB
Markdown
# cognee MCP server
|
|
|
|
### Installing Manually
|
|
A MCP server project
|
|
=======
|
|
1. Clone the [cognee](https://github.com/topoteretes/cognee) repo
|
|
|
|
2. Install dependencies
|
|
|
|
```
|
|
brew install uv
|
|
```
|
|
|
|
```jsx
|
|
cd cognee-mcp
|
|
uv sync --dev --all-extras --reinstall
|
|
```
|
|
|
|
3. Activate the venv with
|
|
|
|
```jsx
|
|
source .venv/bin/activate
|
|
```
|
|
|
|
4. Add the new server to your Claude config:
|
|
|
|
The file should be located here: ~/Library/Application\ Support/Claude/
|
|
```
|
|
cd ~/Library/Application\ Support/Claude/
|
|
```
|
|
You need to create claude_desktop_config.json in this folder if it doesn't exist
|
|
Make sure to add your paths and LLM API key to the file bellow
|
|
Use your editor of choice, for example Nano:
|
|
```
|
|
nano claude_desktop_config.json
|
|
```
|
|
|
|
```
|
|
{
|
|
"mcpServers": {
|
|
"cognee": {
|
|
"command": "/Users/{user}/cognee/.venv/bin/uv",
|
|
"args": [
|
|
"--directory",
|
|
"/Users/{user}/cognee/cognee-mcp",
|
|
"run",
|
|
"cognee"
|
|
],
|
|
"env": {
|
|
"ENV": "local",
|
|
"TOKENIZERS_PARALLELISM": "false",
|
|
"LLM_API_KEY": "sk-"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
Restart your Claude desktop.
|
|
|
|
### Installing via Smithery
|
|
|
|
To install Cognee for Claude Desktop automatically via [Smithery](https://smithery.ai/server/cognee):
|
|
|
|
```bash
|
|
npx -y @smithery/cli install cognee --client claude
|
|
```
|
|
|
|
Define cognify tool in server.py
|
|
Restart your Claude desktop.
|
|
|
|
|
|
To use debugger, run:
|
|
```bash
|
|
mcp dev src/server.py
|
|
```
|
|
Open inspector with timeout passed:
|
|
```
|
|
http://localhost:5173?timeout=120000
|
|
```
|
|
|
|
To apply new changes while developing cognee you need to do:
|
|
|
|
1. `poetry lock` in cognee folder
|
|
2. `uv sync --dev --all-extras --reinstall`
|
|
3. `mcp dev src/server.py`
|
|
|
|
### Development
|
|
In order to use local cognee build, run in root of the cognee repo:
|
|
```bash
|
|
poetry build -o ./cognee-mcp/sources
|
|
```
|
|
After the build process is done, change the cognee library dependency inside the `cognee-mcp/pyproject.toml` from
|
|
```toml
|
|
cognee[postgres,codegraph,gemini,huggingface]==0.1.38
|
|
```
|
|
to
|
|
```toml
|
|
cognee[postgres,codegraph,gemini,huggingface]
|
|
```
|
|
After that add the following snippet to the same file (`cognee-mcp/pyproject.toml`).
|
|
```toml
|
|
[tool.uv.sources]
|
|
cognee = { path = "sources/cognee-0.1.38-py3-none-any.whl" }
|
|
```
|