学习记录管理服务器

TIL MCP서버

GitHub: https://github.com/kangraemin/mcp-learning

记录、搜索和回顾在与学习内容（TIL:Today I Learned）对话期间讨论的内容的MCP服务器。

用自然语言对Claude说的话，他会自己在GitHub上保存标记文件。

会变成这样的。

说起来克劳德做的事 |--------|-----------------| |“把今天学的Python记录下来”|写TIL并保存在GitHub上| |“整理一下刚才讨论的代币优化”|把对话内容摘要保存到GitHub上| “这周学到了什么？”拿出这周的记录给大家看 |“帮我查MCP相关记录”|用关键词搜索并显示结果| |“请写每周回顾”|分析本周的记录，写回忆录|

安装

事前准备

• 克劳德代码 安装
• gh命令行界面 安装+登录

# gh CLI 설치 후
gh auth login

视窗: 安装gh CLI Windows 在 .msi 下载

uv安装

macOS/Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows（PowerShell）

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

注册MCP服务器

claude mcp add -s user --transport stdio til-server \
  -- uvx til-server

Windows（PowerShell）

claude mcp add -s user --transport stdio til-server `
  -- uvx til-server

-s user 如果不运行，则只注册当前项目。在所有项目中使用 -s user请粘贴。

重启Claude Code就结束了。

首次使用

在Claude Code中记录任何东西：

오늘 배운 거 기록해줘

首次使用时 {GitHub유저명}/til-notes 如果没有记录，就会自动生成。

之后，所有TIL将作为标记文件存储在相应的记录中：

til-notes/
  tils/
    2026-02-23-python-.md
    2026-02-23-mcp-.md

如果想保存在其他记录中

claude mcp add -s user --transport stdio til-server \
  -e TIL_GITHUB_REPO=username/my-notes \
  -- uvx til-server

要在没有gh CLI的情况下直接通过令牌进行身份验证，请：

claude mcp add -s user --transport stdio til-server \
  -e TIL_GITHUB_REPO=username/my-notes \
  -e GITHUB_TOKEN=ghp_xxxx \
  -- uvx til-server

如果想保存到Notion

1.发放Notion Integration令牌

1. 概念整合 连接
2. “新整合” 点击→输入名称→创建
3. “内部集成令牌” 复制（secret_xxxx 形状）

2.准备Notion数据库

在Notion中直接创建数据库，并在Integration中 共享 授权。

数据库需要以下属性： 属性名类型 |--------|------| |姓名|职务| |ID|编号| |类别|选择| |标签|多选| |创建时间|日期| |更新时间|日期|

从数据库URL复制ID： notion.so/workspace/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx?v=...

3.注册MCP服务器

claude mcp add -s user --transport stdio til-server \
  -e TIL_BACKEND=notion \
  -e NOTION_TOKEN=secret_xxxx \
  -e NOTION_DATABASE_ID=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
  -- uvx til-server

Windows（PowerShell）

claude mcp add -s user --transport stdio til-server `
  -e TIL_BACKEND=notion `
  -e NOTION_TOKEN=secret_xxxx `
  -e NOTION_DATABASE_ID=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx `
  -- uvx til-server

代币是Claude Desktop config（~/.claude/claude_desktop_config.json）的 env 只存储在项目中，不包括在代码或记录中。

动作原理

사용자: "Python 배운 거 기록해줘"
    ↓
Claude Code → Claude AI (어떤 도구 쓸지 판단)
    ↓
Claude AI → "create_til 써줘"
    ↓
Claude Code → TIL MCP 서버 (로컬에서 실행 중)
    ↓
TIL MCP 서버 → GitHub API → til-notes 레포에 .md 파일 생성

网段：Claude Code Anthropic AI服务器 本地区段：Claude Code MCP服务器 存储库：GitHub记录（标记文件）

提供的功能

Tools（行为）

名称说明 |------|------| | create_til |保存TIL合成和对话摘要| | update_til |修改现有TIL | | delete_til |删除TIL | | search_til |按关键字/标签/类别搜索| | add_tag |添加标签| | export_til |导出为Markdown |

Resources（查询）

URI说明 |-----|------| | til://list |完整列表| | til://list/today |今日记录| | til://list/week |最近7天的记录| | til://{id} |特定TIL详细信息| | til://tags |标签列表| | til://stats |学习统计信息|

Prompts（模板）

名称说明 |------|------| | write_til | TIL合成指南| | weekly_review |生成每周回顾| | suggest_topics |推荐以下学习主题| | summarize_learnings |历史学习摘要| | discussion_recap |整理对话讨论内容|

技术堆栈