Identity Server

Identity Server

A local MCP server that maintains and serves personal identity context to LLMs.

Installation

# Clone and set up virtual environment
git clone https://github.com/ruthvik-947/identity-server.git
cd identity-server
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -e .

Note: Always run commands from the virtual environment. The project uses sentence-transformers and sqlite-vec for semantic search, which require specific dependency versions.

Quick Start

1. Initialize your identity directory:

identity init

1. Edit ~/.identity/identity.yaml with your info

1. Configure sources in ~/.identity/sources.yaml

1. Sync your sources:

identity sync

1. Add to Claude Code's MCP config:

{
  "mcpServers": {
    "identity": {
      "command": "/path/to/identity-server/.venv/bin/identity",
      "args": ["serve"]
    }
  }
}

Replace /path/to/identity-server with your actual installation path (e.g., ~/.local/identity-server).

CLI Commands

• identity init - Initialize identity directory
• identity status - Show current identity
• identity sync - Sync all sources
• identity sources - List configured sources
• identity serve - Start MCP server

MCP Tools

• get_identity() - Core identity info
• get_projects() - Indexed projects
• get_reading() - Reading list items
• query(question) - Semantic search
• list_sources() - Configured sources
• add_source(description) - Setup instructions

Source Types

• local_files - Markdown/text files via glob
• git_repos - README, commits, languages
• rss - RSS/Atom feeds
• custom - Python script connectors

Custom Connectors

Create Python scripts to pull data from any source (APIs, databases, etc.).

1. Create a connector in ~/.identity/connectors/:

# ~/.identity/connectors/my_connector.py

def fetch(config):
    """
    Args:
        config: dict from sources.yaml 'config' field

    Returns:
        list of dicts with: title, body, tags (optional), timestamp (optional)
    """
    return [
        {
            "title": "Example Item",
            "body": "Content goes here...",
            "tags": ["tag1", "tag2"],
        }
    ]

2. Add to sources.yaml:

sources:
  - name: my-source
    type: custom
    connector: connectors/my_connector.py  # relative to ~/.identity
    privacy: private
    config:  # passed to fetch()
      api_key: "..."

3. Run identity sync to execute connectors and index results.

Connectors only run during sync—the MCP server queries the local database.

Privacy

Tag sources as public or private. Private content is excluded from MCP queries.