2026-07-03 | GKD软件分享

前言

GKD（搞快点）作为一款Android广告自动跳过工具，其核心能力依赖规则订阅。相信有很多人曾经使用过"李跳跳"这类软件，那么你也一定会喜欢上GKD的。

食用方式

订阅配置

GKD去广告规则可以通过订阅来实现，第三方订阅列表可在https://github.com/topics/gkd-subscription 查看（需用外网），订阅链接为json5形式。

GIthub网站内有持续更新的订阅，您可进入对应仓库，对应README说明直接Copy链接填入应用内的订阅即可。

• 禁止在国内平台传播

• 本教程仅供学习交流使用

从零搭建拾光课程表 MCP 服务器：一次 AI 工具化的实践

2026-06-14 | 拾光课程表MCP开发日志

前言

最近在为拾光课程表构建智能问答服务时，我接触到了 MCP（Model Context Protocol） —— 一个让 AI 大模型能够调用外部工具的开放协议。经过几天的摸索，我成功搭建了一个拾光课程表专属的 MCP 知识库服务器，并部署到了云服务器上。

这篇文章记录了整个过程：从了解 MCP 是什么，到动手写代码、踩坑、部署、调试的完整经历。

一、什么是 MCP？

MCP（Model Context Protocol） 是由 Anthropic 提出的一个开放标准协议，用于在 AI 大模型与外部工具/数据源之间建立标准化的连接。

简单来说：

传统方式：AI 只能基于训练数据回答问题
MCP 方式：AI 可以调用外部工具（搜索、查询数据库、读文件等）

MCP 定义了三种核心能力：

• Tools（工具）：AI 可以调用的函数，比如搜索知识库、获取数据
• Resources（资源）：AI 可以读取的数据源，比如文件、API 返回
• Prompts（提示模板）：预定义的提示词模板

MCP 的传输方式

MCP 支持两种传输模式：(Rinty已经部署好MCP服务，您可直接使用 详见 五、部署与验证)

二、为什么要做拾光课程表的 MCP 服务器？

拾光课程表作为一个课程表应用，用户经常会问：

• "怎么导入课表？"
• "课程提醒不响怎么办？"
• "怎么分享课表给同学？"
• "支持哪些学校的教务系统？"

这些问题的答案都在我们的文档里，但分散在不同的页面和 FAQ 中。如果有一个 AI 助手能够直接从知识库中检索答案，用户体验会好很多。

MCP 正好提供了这个桥梁：让 AI 大模型能够主动查询我们的知识库，而不是凭"记忆"回答。

三、技术实现

项目结构

shiguang-server/
├── src/
│   └── index.ts
├── knowledge/  # 知识库（Markdown 文件）
│   ├── index.md
│   ├── faq/    # 常见问题
│   └── guide/  # 使用指南
├── Dockerfile
├── docker-compose.yml
├── package.json
└── tsconfig.json

使用技术

• Runtime: Node.js
• Language: TypeScript (ESM)
• SDK: @modelcontextprotocol/sdk ^1.27.1
• Web 框架: Express（用于 HTTP 模式）
• 部署: Docker + Docker Compose

核心设计

1. 知识库加载

知识库使用 Markdown 文件 + YAML frontmatter 组织：

---
title: 课表导入
tags:
    - 导入
    - 教务系统
---

# 课表导入

拾光课程表支持多种方式导入课表...

服务器启动时递归扫描 knowledge/ 目录，解析所有 .md 文件，构建内存知识库：

function loadKnowledgeBase(): KnowledgeItem[] {
  const items: KnowledgeItem[] = [];
  const mdFiles = getAllMdFiles(KNOWLEDGE_DIR);
  
  for (const filePath of mdFiles) {
    const rawContent = fs.readFileSync(filePath, "utf-8");
    const { metadata, body } = parseFrontmatter(rawContent);
    // ... 提取标题、标签、内容摘要
    items.push({ title, filename, tags, content, summary });
  }
  
  return items;
}

2. 实现的 6 个 MCP 工具

3. 双模式传输

同一个服务器支持两种启动方式：

# stdio 模式 —— 本地客户端（VS Code、Cursor）
node build/index.js

# HTTP 模式 —— 远程客户端（Cherry Studio、picoclaw）
node build/index.js --http 3030

通过命令行参数切换，核心代码共用同一套工具处理逻辑。

四、踩坑记录

坑 1：Accept 头不完整（在使用picoclaw时遇到的问题）

问题：部分 MCP 客户端发送请求时，Accept 头只包含 application/json，但 StreamableHTTPServerTransport 要求同时接受 application/json 和 text/event-stream。

表现：服务器返回 400 错误，客户端无法连接。

解决：在 Express 中间件中自动补全 Accept 头：

app.all("/mcp", async (req, res) => {
  const accept = req.headers["accept"] || "";
  if (!accept.includes("text/event-stream") || !accept.includes("application/json")) {
    req.headers["accept"] = "application/json, text/event-stream";
  }
});

坑 2：Docker 镜像过大

问题：初始镜像包含完整的 node_modules 和开发依赖，镜像体积超过 800MB。

解决：使用多阶段构建（multi-stage build）：

# 阶段一：编译
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npx tsc -p tsconfig.json

# 阶段二：运行
FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY --from=builder /app/build ./build
COPY knowledge ./knowledge
CMD ["node", "build/index.js", "--http", "3030"]

坑 3：跨服务器部署

问题：如果将项目完整搬移到服务器，那势必要重新部署环境，因此需要本地构建的 Docker 镜像需要部署到远程云服务器。

解决：使用 docker save / docker load 方式：

# 本地导出
docker save shiguang-mcp -o shiguang-mcp-server.tar
# 传输到服务器
scp shiguang-mcp-server.tar user@server:/opt/
# 服务器导入

五、部署与验证

Docker Compose 一键部署

services:
  shiguang-mcp:
    image: shiguang-mcp:latest
    container_name: shiguang-mcp
    restart: unless-stopped
    ports:
      - "3030:3030"
    volumes:
      - /path/to/school_index.pb:/data/school_index.pb:ro
    environment:
      - SCHOOL_INDEX_PB=/data/school_index.pb

验证 MCP 协议

# 健康检查
curl https://mcp.rinty.xyz/shiguang/health
# → {"status":"ok","service":"shiguang-mcp-server","version":"1.0.0"}

# MCP 握手
curl -X POST https://mcp.rinty.xyz/shiguang/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-11-25",
      "capabilities": {},
      "clientInfo": {"name": "test", "version": "1.0.0"}
    },
    "id": 1
  }'
# → 200 OK + session-id

接入 picoclaw

在 picoclaw 配置中添加 MCP 服务器：

！！！注意！！！

https://monitor.rinty.xyz/
MCP服务监测上线，已停止使用IP端口使用MCP的功能，转由https://mcp.rinty.xyz/shiguang/ 提供MCP服务使用https://mcp.rinty.xyz/shiguang/health作为健康监测网址
目前MCP处于开发中，后续可能会开发MCP Hub作为MCP共享平台。因此本MCP链接不保证长期有效，若无法使用请访问监测平台获取最新mcp服务链接，感谢您的支持！

mcp:
  servers:
    - name: shiguang
      type: http
      url: "https://mcp.rinty.xyz/shiguang/"

如果您使用WebUI版的picoclaw的话，可在

配置 ==> MCP ==>MCP服务

添加好您的MCP服务，然后就可以使用询问，例如:

回复案例一	回复案例二

重启后日志显示连接成功：

INF mcp > Connected to MCP server protocol=2025-11-25 server=shiguang serverName=shiguang-server
INF mcp > Listed tools from MCP server server=shiguang toolCount=6
INF mcp > MCP tools registered successfully total_registrations=6 unique_tools=6

六、思考与展望

MCP 的价值

MCP 让 AI 从"背答案"变成了"查资料"。对于拾光课程表这样的应用，这意味着：

1. 知识库可以实时更新 —— 添加新文档后，AI 立即可用，无需重新训练
2. 答案更准确 —— AI 基于官方文档回答，而不是靠猜测
3. 可扩展 —— 未来可以添加更多工具，比如直接查询用户的课表

MCP 的发现机制

目前 MCP 还处于早期阶段，没有统一的服务发现和注册机制。每个客户端都需要手动配置 MCP 服务器地址。我在考虑构建一个 MCP 社区/平台：

• MCP Gateway（网关）：统一入口，客户端只需连一个地址
• MCP Hub（注册中心）：开发者注册服务器，用户搜索/浏览/一键接入
• 工具市场：类似 Skill 商店，降低使用门槛

下一步计划

• 优化知识库内容，覆盖更多 FAQ
• 探索 picoclaw 的工具调用机制，让 LLM 能正确使用 MCP 工具
• 研究 MCP Gateway 的可行性
• 考虑支持 MCP Resources 和 Prompts

七、相关资源

• MCP 官方文档
• MCP SDK (TypeScript)
• 拾光课程表 GitHub
• 拾光课程表介绍网站

本文由拾光课程表开发者撰写，记录了从零搭建 MCP 服务器的完整过程。如果你也在考虑为自己的项目接入 AI 能力，MCP 是一个值得尝试的方向。

致即将或刚刚完成人生重要阶段的你：

此刻，你或许正站在知识的十字路口，手握笔杆，心怀对未来的憧憬与忐忑。2026年的夏天，对你而言不仅是季节的更替，更是成长轨迹上一个清晰的刻度。作为一位25年刚经历高考的考生，我想与你分享一些思考，也期待你能在此基础上找到属于自己的答案。

一、考试只是检验，而非定义

考试是学习过程的阶段性反馈，它系统性地检验了你在特定时间段内对知识的掌握程度、逻辑思维能力以及抗压能力。它是一份来自过去努力的“成绩单”，而非你全部价值的“判决书”。

我不会把每一次模拟考试当作是我的最终分数，因为我明白每一次的测试题型什么的都不相同，所以根本没有可比较性，我们要做的就是吃透每一个错题，解决每一个知识点。

二、不必有太大的压力

面对大考，焦虑是自然的生理与心理反应。关键在于如何将压力转化为动力。建议：

1. 给自己正反馈，告诉自己一定是能考好的，用平常心去对待它，它不过只是一次小测试

2. 旁边人发生了什么都与我无关，那是别人的事情，我不必掺和

3. 多运动，跑跑步

   

三、送给未来的你

中高考是重要的路标，但绝非终点。未来的大学或职业道路

• 自主学习能力：在信息时代，主动构建知识体系的能力至关重要。

• 解决问题的能力：面对未知挑战，能综合运用资源找到解决方案。

• 坚韧与适应力：人生充满变化，保持弹性与韧性是长期发展的核心。

结语

没人喜欢去经历高三，但经历过高三，回想起来那绝对是一段难以忘却的时光，这些是青春最耀眼的时光。请多多留下些痕迹吧！

请记住，这场考验的终极目的，并非将你置于统一的标尺下衡量，而是为了赋予你一把更坚实的钥匙，去开启下一扇门。门后的世界辽阔无比，等待你的探索与创造。

无论结果如何，你为此付出的日日夜夜，所锤炼出的专注力、毅力与思维方式，都已成为你生命资产的一部分，它们将在未来更漫长的赛道上持续为你赋能。

祝你笔锋所至，皆为心之所向。

预祝中考 高考加油！🫠毕业快乐！

一位始终相信你的同行者

2026年6月

不是看到希望才坚持，而是坚持了才看到希望。

希望在Rinty中可以帮你解决一些生活中的小问题

亲爱的 Rinty 用户与伙伴：

​2025 已经封装成册，2026 正平铺在眼前。🥳

​作为一个小型团队，我们常被问起：Rinty 到底是什么？有人说它是一个自习打卡的工具，有人说它是一个极客聚集的社区。但在我们心中，Rinty 更像是一个由大家共同构建的“数字自习室”。在这里，每一次打卡、每一行评论、每一个反馈，都在赋予这个空间新的生命力。😁

​我们深知，每一个选择 Rinty 的人，都是在试图变得更好的人。😙

所以新的一年，我们不打算谈论宏大的未来，我们只想谈论“陪伴”：

​陪伴你度过每一个感到孤单的自习深夜；

​陪伴你解决每一个棘手的逻辑 Bug；

​陪伴你从一个念头，走向一个成果。🥰

​2026 年，Rinty 会继续保持它的中规中矩——稳定、简洁、好用。我们会守护好这一方净土，让你在追求梦想的路上，总能有一个可以落脚、可以专注的地方。🤗

​新年快乐！愿新的一年，每一份努力都有回响。😜

—— Rinty 团队

Rinty地震监测平台

项目GIthub开源地址：https://github.com/Xuan-Xuann/EarthQuakeDecte

链接：earthquake.rinty.xyz

设备 ESP32-WROOM + MPU6050 + 若干跳线

如果后面需要提高精度，首先传感器不能太差，其次需要加一些噪声滤波算法，以减少错误值的出现几率。

然后传感器放置应该装在固定容器，将容器和地面形成强链接，注意X Y Z三轴方向指向

此项目只是作为地震检测演示效果，并不具备任何预警能力！

介于MPU6050加速度传感器精度以及量程有限，无法代替或作为专业设备进行测量，请勿发布您的测量数据至任何公开平台，以免引起惊恐，如过造成任何问题，由转发者承担相应法律责任！

如果有任何投稿，请联系Email：heyuxuan200704@qq.com 
十分感谢您的投稿，我会在文件处标明出处！

不是看到了希望才坚持，而是坚持了才看到希望。

温馨提示：点击下载

教材：

教材-高等数学上册-同济七版.pdf

高等数学上册第八版(同济大学数学科学院编)(Z-Library).pdf

高等数学第8版下册.pdf

宋浩试题：

宋浩高等数学精选750题上册 (宋浩) .pdf

李林试题：

26李林880题-试题册（数二）.pdf

26李林880题-解析册（数二）.pdf

数三：

2026考研660习题册数三【公众号：再来一杯柠.pdf

2026考研660答案册数三【公众号：再来一杯柠.pdf

操作流程

确保文件命名正确

首先确保所有文件均以xxx-姓名-xxx形式命名。

生成txt文件

将bat文件拖动到统计文件夹根目录下，运行文件生成对应.txt文件。

使用excel进行统计

这里使用了excel，可以直接与花名册进行比对

进行比对

表格后添加此公式 自动提取姓名 =TEXTBEFORE(TEXTAFTER(List__2[@Column1],"-",1),"-",1)

插入以下公式，使其与花名册姓名进行比对 如果有提交记录 则显示相应姓名 如无 则#N/A

=VLOOKUP(D2,B:B,1,0)

数据统计

最后，可使用此公式来统计数量

=COUNTIF(E2:E44,"#N/A")

更新数据

直接双击bat生成txt覆盖原有文件，excel中刷新表以同步更新，由于表格均使用公式化，实现半自动化。

附件

点击即可下载
(请解压使用)文件统计工具.rar

你好哇，欢迎来到Xuann的博客～

在这里，我想留出一方小小的空间，和你分享一些属于我的经历，也希望能带给你一点温暖和力量。

还记得那段备考的日子，我也曾无数次怀疑过自己。看着别人轻松拿下高分，而我却一遍又一遍地被模拟考试打击；也曾在夜深人静时，一边看着卷子发呆，一边对自己说“是不是我真的不行”。那种焦虑和不安，我懂。

可是后来，我慢慢明白，成长从来不是一条平坦的路。那些不如意的考试成绩、那些被否定的时刻，并不是在告诉你“你不够好”，而是在提醒你——你还在路上。

我也曾以为，自己不会在高考中取得什么好成绩。可结果却出乎意料——那一次，我考出了从未有过的高分。也许在别人眼里，这个分数并不耀眼，但对我来说，它是我努力的证明，是我和无数次想要放弃的自己对抗之后的小小胜利。

所以，如果你也正经历着低谷、焦虑、或者对未来的迷茫，请记得：没有一场努力是白费的。每一次失落，都是为下一次突破积蓄力量。你不是不行，只是你还没到达属于你的那段光亮。

别着急，也别灰心。成绩只是人生的一部分，它不会定义你所有的价值。最重要的是，你要相信自己仍然有选择的权利——选择继续前行、选择不放弃、选择相信努力的意义。

未来会在你不经意的时候，悄悄对你说一声：“你看，你做到了。”

——来自Xuann的一点心声 💫

愿看到这里的你，也能在属于自己的道路上闪闪发光。 加油🫠！

‘人无法拥有青春和 对青春的感受，好好珍惜，少年’