校园失物招领MCP服务器

一个兼容Claude Desktop的MCP服务器,允许用户通过简单的CLI或LLM界面报告、跟踪和总结校园内的失物招领物品。

  • by utkarshagawade17
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 utkarshagawade17/campuslostfoundmcp

使用说明

🎒 校园失物招领MCP服务器

与Claude Desktop兼容的MCP(模型上下文协议)服务器,允许用户通过简单的CLI或LLM界面报告、跟踪和汇总校园内丢失和找到的物品。


🚀 特性

  • 报告丢失或找到的物品
  • 查看报告项目列表
  • 获取最新丢失/找到的物品
  • 生成摘要提示,让Claude进行推理
  • 使用本地文本文件进行持久存储
  • 与Claude Desktop(Anthropic)无缝协作

📁 项目结构

Campus LostFoundMCP/ ├── main.py#使用FastMCP定义MCP服务器 ├── lost.txt#存储丢失的物品条目(自动创建) ├── found.txt#存储已找到的项目条目(自动创建) ├── pyproject.toml#uv/mcp环境配置 ├── uv.lock#依赖锁定文件 └── README.md


🧪 工具功能

这些可以在Claude Desktop中直接调用:

report_lost("wallet near cafeteria")
report_found("blue bottle in gym")
show_lost()
show_found()
latest_lost()
latest_found()
summary_prompt()

🛠️ 安装说明

  1. 克隆存储库:

    git clone https://github.com/<your-username>/CampusLostFoundMCP.git cd CampusLostFoundMCP

  2. 确保已安装Python 3.11+

  3. 安装依赖项:

    uv init . uv add "mcp[cli]"

  4. 运行服务器:

    uv run main.py

🧩 Claude桌面集成

将以下内容添加到claude_desktop_config.json中:

{ "mcpServers": { "Campus Lost & Found": { "command": "uv", "args": [ "--directory", "/absolute/path/to/CampusLostFoundMCP", "run", "main.py" ] } } }

📬 未来的增强功能

类别过滤(如电子产品、书籍)

基于日期的搜索

SQLite或云存储支持

松弛或电子邮件通知