batteryshark/mcp-userinfo

User Info MCP Server

A simple MCP (Model Context Protocol) server that provides user information management through tool calls. Built with FastMCP for efficient context sharing.

Features

• Static Mode: Returns pre-configured user information from user_info.txt
• Dynamic Mode: Allows session-based user info storage when USER_MANAGED=true
• Multiple Transports: Supports both stdio and HTTP communication
• Date Integration: Automatically includes current date in responses

Quick Start

Installation

# Clone or download the project
cd mcp-userinfo

# Install dependencies
uv sync

Running the Server

# Static mode (default)
uv run python server.py

# Dynamic mode with user management
USER_MANAGED=true uv run python server.py

# HTTP mode
PORT=8000 uv run python server.py

Available Tools

Always Available

• get_user_info(): Returns user information with current date header

Dynamic Mode Only (USER_MANAGED=true)

• put_user_info(info: str): Store user info for the current session (overwrites existing)

Configuration

Static Mode

Edit user_info.txt in the project root to customize the default user information:

Name: Your Name
Company: Your Company
Location: Your Location
Role: Your Role

Interests:
- Interest 1
- Interest 2

Professional Skills:
- Skill 1
- Skill 2

Environment Variables

MCP Client Configuration

VS Code / Cursor (stdio)

Add to .vscode/mcp.json or .cursor/mcp.json:

{
  "mcpServers": {
    "userInfoServer": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/path/to/mcp-userinfo"
    }
  }
}

With Dynamic Mode

{
  "mcpServers": {
    "userInfoServer": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/path/to/mcp-userinfo",
      "env": {
        "USER_MANAGED": "true",
        "USER_INFO_PATH": "~/Documents/my_profile.txt"
      }
    }
  }
}

HTTP Transport

{
  "mcpServers": {
    "userInfoServer": {
      "type": "http",
      "url": "https://your-domain.com/mcp/"
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "userInfoServer": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/path/to/mcp-userinfo"
    }
  }
}

Usage Examples

Getting User Info

# The tool automatically includes current date
user_info = await get_user_info()
# Returns: "=== CURRENT DATE: 2024-01-15 ===\nUSE THIS DATE FOR ALL CALCULATIONS\n\n[your user info]"

Storing User Info (Dynamic Mode)

await put_user_info("""
Name: John Doe
Company: Tech Corp
Location: San Francisco, CA
Role: Software Engineer

Interests:
- Python development
- Machine learning
- Open source
""")

Project Structure

mcp-userinfo/
├── server.py          # Main MCP server implementation
├── user_info.txt      # Static user information file
├── pyproject.toml     # Project configuration
└── README.md         # This file

Dependencies

• fastmcp>=2.11.3 - MCP server framework
• uv - Python package manager (for running)

Notes

• In dynamic mode, user information is stored in memory and persists only for the current session
• The current date is automatically included in all responses and should be trusted for calculations
• Static mode falls back to a default message if user_info.txt doesn't exist