Spirrow-Prismind

MCP Server for Context-Aware Knowledge Management

An MCP (Model Context Protocol) server that integrates multiple data sources—Google Drive, RAG (Retrieval-Augmented Generation), and MCP Memory Server—to provide context-aware knowledge management for AI assistants.

Note: 日本語版は README.ja.md を参照してください。

Features

• Session Management: Save and restore work states, automatically suggest relevant documents

• Project Management: Switch between multiple projects, search for similar projects

• Document Operations: Google Docs integration with automatic catalog registration

• Catalog Management: Semantic search with Google Sheets synchronization

• Knowledge Management: RAG-based knowledge storage and retrieval

Related MCP server: mcp-google-gdrive

Requirements

• Python 3.11 or higher

• Google Cloud project with OAuth 2.0 credentials

• RAG server (ChromaDB compatible)

• MCP Memory Server (optional)

Installation

# Clone the repository
git clone https://github.com/SpirrowGames/spirrow-prismind.git
cd spirrow-prismind

# Install the package
pip install -e .

Configuration

1. Copy the example config:

   cp config.toml.example config.toml

2. Set up Google OAuth credentials:

   • Create a project in Google Cloud Console

   • Enable Google Docs, Drive, and Sheets APIs

   • Create OAuth 2.0 credentials (Desktop application)

   • Download credentials.json and place it in the config directory

3. Configure external services in config.toml:

   • RAG Server endpoint (ChromaDB compatible)

   • MCP Memory Server connection (optional)

Usage

With Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "prismind": {
      "command": "spirrow-prismind",
      "env": {
        "PRISMIND_CONFIG": "/path/to/config.toml"
      }
    }
  }
}

With Claude Code

Add to your Claude Code settings:

{
  "mcpServers": {
    "prismind": {
      "command": "spirrow-prismind",
      "env": {
        "PRISMIND_CONFIG": "/path/to/config.toml"
      }
    }
  }
}

Available Tools

Session Management

start_session / end_session / save_session / delete_session accept an optional author argument. It adds a partition segment to the session key (prismind:session:{project}:{user}:{author}), so one project+user can hold multiple independent contexts — one per author/role. An empty author keeps the legacy key for backward compatibility.

Project Management

Document Operations

Catalog Operations

Knowledge Operations

Progress Management

Architecture

┌──────────────────────────────────────────────────────────────┐
│                       MCP Server                             │
│  ┌────────────────────────────────────────────────────────┐  │
│  │                        Tools                           │  │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐      │  │
│  │  │ Session │ │ Project │ │Document │ │Knowledge│ ...  │  │
│  │  └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘      │  │
│  └───────┼──────────┼──────────┼──────────┼─────────────┘  │
│          │          │          │          │                 │
│  ┌───────┴──────────┴──────────┴──────────┴─────────────┐  │
│  │                    Integrations                       │  │
│  │  ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐         │  │
│  │  │  RAG   │ │ Memory │ │  Docs  │ │ Drive  │         │  │
│  │  │ Client │ │ Client │ │ Client │ │ Client │         │  │
│  │  └────┬───┘ └────┬───┘ └────┬───┘ └────┬───┘         │  │
│  └───────┼──────────┼──────────┼──────────┼─────────────┘  │
└──────────┼──────────┼──────────┼──────────┼────────────────┘
           │          │          │          │
           ▼          ▼          ▼          ▼
      ┌────────┐ ┌────────┐ ┌────────────────────┐
      │ChromaDB│ │ Memory │ │    Google APIs     │
      │  RAG   │ │ Server │ │ Docs/Drive/Sheets  │
      └────────┘ └────────┘ └────────────────────┘

Development

Setup

# Install with dev dependencies
pip install -e ".[dev]"

Testing

pytest

Code Quality

# Format code
ruff format .

# Lint and fix
ruff check --fix .

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository

2. Create your feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add some amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Related Projects

• Model Context Protocol - The protocol specification

• MCP Servers - Official MCP server implementations