🎒 Campus Lost & Found MCP Server

What is 🎒 Campus Lost & Found MCP Server?

A Claude Desktop-compatible MCP server that lets users report, track, and summarize lost and found items on campus via a simple CLI or LLM interface. It stores data persistently using local text files and is designed for anyone managing campus lost‑and‑found records.

How to use 🎒 Campus Lost & Found MCP Server?

Clone the repository, ensure Python 3.11+ is installed, run uv init . and uv add "mcp[cli]", then start the server with uv run main.py. For Claude Desktop integration, add the server definition to claude_desktop_config.json with the command uv --directory /path/to/CampusLostFoundMCP run main.py. Once connected, call the provided tool functions (e.g., report_lost("wallet near cafeteria"), show_lost(), summary_prompt()) directly inside Claude Desktop.

Key features of 🎒 Campus Lost & Found MCP Server

• Report lost or found items via text description
• View complete lists of reported items
• Retrieve the latest lost or found item
• Generate a summary prompt for Claude to reason about
• Persistent storage using local text files
• Works seamlessly with Claude Desktop (Anthropic)

Use cases of 🎒 Campus Lost & Found MCP Server

• A student reports a lost wallet near the cafeteria via chat
• A campus admin views all found items to match them with reports
• Claude generates a summary of recent lost/found activity for staff
• Quickly retrieve the most recently reported lost or found item

FAQ from 🎒 Campus Lost & Found MCP Server

What tools does the server provide?

It provides eight tool functions: report_lost(), report_found(), show_lost(), show_found(), latest_lost(), latest_found(), and summary_prompt().

How does it store data?

Data is stored in two local text files (lost.txt and found.txt) that are auto‑created on first use.

What are the runtime requirements?

Python 3.11+ and the mcp[cli] package installed via uv. No database or cloud service is required.

How do I connect it to Claude Desktop?

Add a server entry in claude_desktop_config.json with the command uv --directory /absolute/path/to/CampusLostFoundMCP run main.py.

Does it support category filtering or date search?

Not yet; these are planned as future enhancements. Currently all items are stored and listed without filtering.