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

Variable	Description	Default
`USER_MANAGED`	Enable dynamic user info storage	`false`
`USER_INFO_PATH`	Custom path to user info file	`user_info.txt`
`HOST`	HTTP server host	`127.0.0.1`
`PORT`	HTTP server port (enables HTTP transport)	-

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

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables AI assistants to access and manage user profile information including name, company, location, role, interests, and skills. Supports both static configuration files and dynamic session-based storage with automatic date context.

Related MCP Servers

Memory Bank MCP Server
ipospelov
A
security
A
license
A
quality
Provides a structured documentation system for context preservation in AI assistant environments, helping users create and manage memory banks for their projects.
Last updated -
3
67
MIT License
RAG Context MCP Server
notbnull
-
security
A
license
-
quality
A lightweight server that provides persistent memory and context management for AI assistants using local vector storage and database, enabling efficient storage and retrieval of contextual information through semantic search and indexed retrieval.
Last updated -
1
MIT License
CastPlan MCP
Ghostseller
A
security
A
license
A
quality
Provides AI assistants with persistent memory of your project architecture, development history, and technical decisions, allowing them to give context-aware coding help without needing repeated explanations.
Last updated -
16
61
1
MIT License
AI Conversation Logger
fablefang
A
security
F
license
A
quality
Enables AI assistants to automatically log and manage conversation history with developers in structured markdown format. Provides powerful search and context suggestions to help AI understand project history and maintain continuity across sessions.
Last updated -
4
1

View all related MCP servers

User Info MCP Server