检索增强生成MCP服务器

# Clone the repository
git clone https://github.com/yourusername/personal-mcp-server.git
cd personal-mcp-server

# Complete automated setup (installs dependencies + runs diagnostics)
make setup

# Configure Claude Desktop (interactive wizard)
make config

# That's it! Restart Claude Desktop (Cmd+Q, then reopen)

# Navigate to where you want to install
cd ~/Projects

# Clone the repository
git clone https://github.com/yourusername/personal-mcp-server.git
cd personal-mcp-server

# Install dependencies (this may take a few minutes)
uv sync

# Verify installation
uv run pytest

make config

# Open the config file in your editor
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "rag-server": {
      "command": "/Users/YourUsername/.local/bin/uv",
      "args": [
        "run",
        "python",
        "-m",
        "rag_server.rag_mcp_chroma"
      ],
      "cwd": "/Users/YourUsername/Projects/personal-mcp-server",
      "env": {}
    }
  }
}

make doctor

Can you add these documents to a collection called "my-notes":
- Document 1: "Python is a high-level programming language"
- Document 2: "Machine learning is a subset of AI"

from rag_server.rag_mcp_chroma import RAGMCPServer

server = RAGMCPServer()
# Use server methods to add documents

make index REPO=/path/to/repo COLLECTION=repo-name

 # Personal RAG MCP server index
   indexme() {
       local repo_path="$PWD"
       local collection_name=$(basename "$PWD")
       local mcp_server_path="/path/to/personal-mcp-server"

       echo "📚 Indexing current directory..."
       echo "  Repository: $repo_path"
       echo "  Collection: $collection_name"
       echo ""

       # Navigate to the MCP server directory, run make, then return
       (cd "$mcp_server_path" && make index REPO="$repo_path" COLLECTION="$collection_name")

       local exit_code=$?
       if [ $exit_code -eq 0 ]; then
           echo ""
           echo "✅ Successfully indexed $collection_name"
       else
           echo ""
           echo "❌ Indexing failed with exit code $exit_code"
           return $exit_code
       fi
   }

Search my "my-notes" collection for information about Python

What collections do I have in my knowledge base?

Delete the "old-notes" collection

personal-mcp-server/
├── rag_server/                 # Main package
│   ├── __init__.py            # Package exports
│   ├── errors.py              # Custom exception classes
│   ├── logging_config.py      # Logging utilities
│   ├── rag_mcp_chroma.py      # MCP server implementation
│   ├── utils.py               # Device detection utilities
│   └── py.typed               # Type hint marker
├── tests/                      # Test suite
│   ├── conftest.py            # Pytest fixtures
│   ├── test_errors.py         # Error handling tests
│   ├── test_logging_config.py # Logging tests
│   └── test_utils.py          # Utility tests
├── docs/                       # Documentation
│   ├── CLAUDE.md              # AI assistant guide
│   ├── mcp-concepts.md        # MCP education
│   ├── rag-explained.md       # RAG education
│   ├── claude-desktop-setup.md # Integration guide
│   ├── usage-examples.md      # Practical examples
│   ├── troubleshooting.md     # Problem solving
│   └── development.md         # Contributor guide
├── pyproject.toml             # Project configuration
├── uv.lock                    # Dependency lock file
├── LICENSE                    # MIT License
└── README.md                  # This file

# Setup and configuration
make setup              # Complete first-time setup
make config             # Configure Claude Desktop
make doctor             # Run system diagnostics

# Testing
make test               # Run all tests
make test-fast          # Quick tests (skip slow ones)
make coverage           # Generate coverage report

# Code quality
make quality            # Run all quality checks
make format             # Auto-format code
make lint               # Check code style
make typecheck          # Type checking with mypy

# Development workflow
make watch-test         # Auto-run tests on file changes
make pre-commit-install # Install git hooks
make all-checks         # All checks before commit

# Utility
make clean              # Clean temporary files
make logs               # View server logs
make benchmark          # Run performance tests
make help               # See all commands

# Recommended: Use make commands
make test               # Run all tests (141 tests)
make test-fast          # Skip slow tests (~15 seconds)
make coverage           # Generate HTML coverage report

# Alternative: Direct pytest
uv run pytest
uv run pytest --cov=rag_server --cov-report=html
uv run pytest tests/test_utils.py
uv run pytest -v

# Recommended: Use make commands
make quality            # Lint + type check (fast)
make format             # Auto-format with ruff
make lint               # Check code style
make typecheck          # Run mypy

# Run all checks before committing
make all-checks         # Quality + tests

# Alternative: Direct commands
uv run ruff check .
uv run ruff check --fix .
uv run ruff format .
uv run mypy rag_server

# Morning: Verify everything works
make doctor

# During development: Auto-run tests
make watch-test

# Before committing
make quality
make test-fast

# One-time: Install pre-commit hooks
make pre-commit-install
# Now quality checks run automatically on git commit!

# Recommended
make run                # Start server

# Alternative methods
uv run personal-mcp-server
uv run python -m rag_server.rag_mcp_chroma
make inspector          # Run queryable server over a webUI 

make doctor

# Check configuration
make doctor

# View Claude Desktop logs
make logs

# Reconfigure if needed
make config

# Reinstall dependencies
uv sync

# Verify installation
make test

# Check performance metrics
make benchmark

# View diagnostics
make doctor

# Clean and start fresh
make clean
make setup

# If still broken, emergency recovery
rm -rf .venv chroma_db
make setup