A
securityA
licenseA
qualityProvides a structured documentation system for context preservation in AI assistant environments, helping users create and manage memory banks for their projects.
Last updated -
3
71
MIT License
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.txtDynamic Mode: Allows session-based user info storage when
USER_MANAGED=trueMultiple 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 |
| Enable dynamic user info storage |
|
| Custom path to user info file |
|
| HTTP server host |
|
| 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 frameworkuv- 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.txtdoesn't exist
This server cannot be installed
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
- -securityAlicense-qualityA 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 -1MIT License
- AsecurityAlicenseAqualityProvides 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 -16611MIT License
- AsecurityFlicenseAqualityEnables 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 -41