Puch MCP Server

🤖 Puch AI MCP服务器

该项目设立了一个 模型上下文协议（MCP） 要连接的服务器 Puch AI。它验证您的应用程序密钥、电话号码，并以markdown格式提供您的简历，供LLM使用。

______________________________________________________________________

🚀 特性

• ✅ 通过Puch应用程序密钥进行身份验证
• 📎 恢复工具（转换 .pdf 或 .md 降价）
• 🌐 URL提取工具（简化或返回原始HTML）
• ☎️ 电话号码验证器
• 🧠 LLM就绪内容格式化

______________________________________________________________________

📁 项目结构

.
├── mcp_server.py         # Main MCP server
├── resume.pdf            # Your resume (can be .md or .pdf)
├── venv/                 # Virtual environment (recommended)
└── README.md             # You're reading it!

______________________________________________________________________

⚙️ 安装说明

1.克隆或复制项目

git clone 
cd 

2.创建虚拟环境

python -m venv venv
source venv/bin/activate       # macOS/Linux
venv\Scripts\activate          # Windows

3.安装依赖项

pip install fastmcp pydantic openai readabilipy markdownify httpx pymupdf

______________________________________________________________________

🧠 配置

编辑 mcp_server.py:

• 替换：

  TOKEN = "your_actual_application_key"
  MY_NUMBER = "91{your phone number}"

使用您的实际应用程序密钥和电话号码（否 + 标志）。

• 把你的 resume.pdf 或 resume.md 在同一个目录中。

______________________________________________________________________

💾 运行服务器

python mcp_server.py

这将在本地启动您的MCP服务器 http://localhost:8085.

______________________________________________________________________

🌍 与Ngrok一起公开

安装ngrok（如果尚未安装）：

npm install -g ngrok  # or brew install ngrok / download from ngrok.com

启动隧道：

ngrok http 8085

你会得到一个公共URL，比如：

https://abc123.ngrok.io

______________________________________________________________________

🤝 与Puch建立联系

在Puch DM/聊天界面中，运行以下命令：

/mcp connect https://abc123.ngrok.io/mcp your_application_key

替换：

• abc123.ngrok.io 使用您的ngrok URL
• your_application_key 用你真正的钥匙

______________________________________________________________________

📎 简历工具要求

• 接受a .md 或 .pdf 文件
• 将内容转换为原始标记/文本
• 返回普通LLM友好字符串
• 自动包含在服务器启动中

______________________________________________________________________

🧪 可用的MCP工具

______________________________________________________________________

✅ 获取URL的示例命令

{
  "url": "https://example.com",
  "raw": false,
  "max_length": 3000
}

______________________________________________________________________

📄 停用虚拟环境

deactivate

______________________________________________________________________

📜 许可证

该项目是Puch AI应用程序的一部分，旨在供个人使用。

______________________________________________________________________

🙋 需要帮助？

如果您遇到问题，请随时ping Puch或查看原始说明。