星战科技xingzhan.cloud
返回市场
朴奇-MCP-编程马拉松

朴奇-MCP-编程马拉松

作者：datavorous2 星标更新：2025-08-11
安装使用来源：spider==github.com

项目介绍

PuchAI 黑客马拉松

🌟 点击使用MCP

<img src="media/mcp.png">

Reddit 研究工具

<img src="media/reddit_demo1.png">

描述：从指定的子版块中抓取最新的帖子，并筛选出包含特定关键词的帖子，然后通过意图评分分析内容以进行市场验证和受众情感分析。

参数：

  • puch_user_id（字符串）：用于速率限制的用户ID
  • query（字符串）：关于您要查找的内容的描述性查询
  • subreddits（字符串列表）：子版块名称列表（不带'r/'前缀）
  • keywords（字符串列表）：使用模糊匹配搜索的关键词
  • threshold（整数，默认值：80）：模糊匹配阈值（0-100）
  • post_limit（整数，默认值：10）：每个子版块检查的新帖子数量（1-35）

冷却时间：每次使用之间需等待80秒

示例提示：

  1. "嘿Puch，我正在推广我的带有Kubernetes EKS设置的MCP，请检查最近是否有人对r/mcp或r/saas感兴趣。"
  2. "我正在构建自己的支付网关服务，请检查r/saas中是否有讨论支付网关的内容，并告诉我如何接近他们。"

数据可视化工具

制作条形图

<img src="media/bar_chart.png">

描述：根据标签和数值数据列表生成可定制样式的条形图图像。

参数：

  • puch_labels（字符串列表）：X轴标签字符串
  • puch_values（浮点数列表）：数值（与标签长度相同）
  • width（整数，默认值：900）：图像宽度（像素）
  • height（整数，默认值：450）：图像高度（像素）
  • bg_color（字符串，默认值："#f8fffe"）：背景颜色
  • bar_color（字符串，默认值："#4ade80"）：条形颜色
  • title（字符串，可选）：图表标题

示例提示：

  1. "创建一个条形图显示销售数据：Q1=15000, Q2=18000, Q3=22000, Q4=17000，标题为'季度销售'。"
  2. "制作一个编程语言的条形图：Python=45, JavaScript=38, Java=32, C++=28, Go=15。"

制作折线图

<img src="media/line_chart.png">

描述：创建折线图可视化展示随时间的趋势或变量之间的关系。

参数：

  • puch_labels（字符串列表）：X轴标签字符串
  • puch_values（浮点数列表）：数值（与标签长度相同）
  • width（整数，默认值：900）：图像宽度（像素）
  • height（整数，默认值：_450）：图像高度（像素）
  • bg_color（字符串，默认值："#f8fffe"）：背景颜色
  • line_color（字符串，默认值："#4ade80"）：线条颜色
  • title（字符串，可选）：图表标题

示例提示：

  1. "给我展示过去6个月网站流量的折线图：Jan=1200, Feb=1350, Mar=1100, Apr=1600, May=1850, Jun=2100。"
  2. "创建一个展示温度趋势的折线图：Mon=22, Tue=24, Wed=19, Thu=25, Fri=27, Sat=23, Sun=21。"

制作饼图

<img src="media/pie.png">

描述：生成具有现代样式、阴影效果和详细图例的饼图，显示百分比和数值。

参数：

  • labels（字符串列表）：饼图的类别标签
  • values（浮点数列表）：每个类别的数值
  • title（字符串，可选）：图表标题
  • width（整数，默认值：1000）：图像宽度（像素）
  • height（整数，默认值：600）：图像高度（像素）

示例提示：

  1. "创建一个展示预算分配的饼图：Marketing=5000, Development=8000, Operations=3000, Sales=4000。"
  2. "制作一个调查响应的饼图：Very Satisfied=45, Satisfied=32, Neutral=15, Dissatisfied=8。"

制作散点图

<img src="media/scatter.png">

描述：创建散点图以可视化两个数值变量之间的关系，可选分类和自定义样式。

参数：

  • x_values（浮点数列表）：X坐标值
  • y_values（浮点数列表）：Y坐标值（与x_values长度相同）
  • labels（字符串列表，可选）：点标签
  • categories（字符串列表，可选）：用于颜色编码的类别
  • colors（字符串列表，可选）：每个点的自定义颜色（十六进制代码）
  • width（整数，默认值：900）：图像宽度（像素）
  • height（整数，默认值：600）：图像高度（像素）
  • bg_color（字符串，默认值："#fafafa"）：背景颜色
  • point_color（字符串，默认值："#4F46E5"）：默认点颜色
  • point_size（整数，默认值：6）：点半径（像素）
  • title（字符串，可选）：图表标题
  • x_label（字符串，可选）：X轴标签
  • y_label（字符串，可选）：Y轴标签

示例提示：

  1. "创建一个展示学习小时数（x）与考试分数（y）相关性的散点图：学习小时数 [2,4,6,8,10,12] 和分数 [65,72,78,85,90,95]。"
  2. "制作一个身高与体重数据的散点图，按不同年龄段分类。"

医药信息提供者

<img src="media/med.png">

描述：从Tata 1mg检索任何给定药物的信息。

参数：

  • medicine_name（字符串）：药物名称

示例提示：

  1. "嘿，药店给了我蒙特鲁卡斯特，这是治疗过敏的正确药物吗？"

用户偏好管理

获取用户偏好

<img src="media/pref_get.png">

描述：通过键检索用户偏好或特定偏好值。

参数：

  • puch_user_id（字符串）：用户ID
  • key（字符串，可选）：要检索的具体偏好键

示例提示：

  1. "我的最爱编程语言是什么？"
  2. "显示我保存的所有偏好。"

保存用户偏好

<img src="media/pref_store.png"> <img src="media/memo_json.png">

描述：将用户的偏好、喜好、兴趣或任何值得记忆的信息保存到持久存储中。

参数：

  • puch_user_id（字符串）：用户ID
  • key（字符串）：偏好类别或键（例如，'favorite_color'）
  • value（字符串）：在给定键下保存的值

示例提示：

  1. "记住我的最爱编程语言是Python。"
  2. "保存我在早上更喜欢咖啡而不是茶。"

任务管理工具

添加待办事项

<img src="media/todo_set.png">

描述：向用户的待办事项列表添加新任务并附带时间戳。

参数：

  • puch_user_id（字符串）：用户ID
  • task（字符串）：任务或待办事项文本

示例提示：

  1. "将'完成MCP文档'添加到我的待办事项列表。"
  2. "我需要记住'打电话给客户关于项目提案'，请将其添加到我的任务中。"

列出待办事项

<img src="media/todo_get.png">

描述：检索并显示所有用户的待办事项，按创建日期排序。

参数：

  • puch_user_id（字符串）：用户ID

示例提示：

  1. "显示我当前的所有任务和待办事项。"
  2. "我现在待办事项列表里有什么？"

删除待办事项

<img src="media/todo_del.png"> <img src="media/todo_json.png">

描述：通过索引号从用户的待办事项列表中删除特定任务。

参数：

  • puch_user_id（字符串）：用户ID
  • index（整数）：从list_todos获取的待办事项索引号（基于1）

示例提示：

  1. "从我的待办事项列表中删除第3项任务。"
  2. "从我的任务中移除第二项。"

注意事项

  • Reddit 抓取器：每用户80秒冷却时间
  • 其他工具：无冷却限制
  • 用户数据存储在user_data.json中
  • 使用锁定进行线程安全文件操作
  • 使用临时文件进行原子写入操作

安装指南

安装 uv

假设您已经安装了Python。 uv 是一个快速的Python包安装器和环境管理器。

安装它：

pip install uv

运行

克隆仓库，填充.env文件，导航到内部并执行以下命令：

uv run src/main.py

默认情况下，它将在端口8085上运行。

设置NGROK

1. 安装ngrok

从以下链接下载并安装ngrok：
https://ngrok.com/download

2. 获取您的Authtoken

  1. 访问：https://dashboard.ngrok.com/get-started/your-authtoken
  2. 复制您的authtoken。
  3. 运行以下命令添加您的token： 
    ngrok config add-authtoken YOUR_AUTHTOKEN
  4. 运行 ngrok http 8085
  5. 复制URL，并在puch.ai/hi上输入 /mcp connect {复制的url}/mcp AUTH_TOKEN。AUTH_TOKEN应与.env文件中的相同。