mcp-starter
一个本地MCP服务器，暴露7个工具，分3类：通用小工具、本地笔记存储、关键词检索知识库。用Streamable HTTP传输，跑成一个长期进程，本机上的多个agent/客户端可以共用同一个server和同一份数据。
安装
npm install
npm run build
启动server
npm run dev # 开发模式，用tsx直接跑 src/index.ts
# 或
npm run build && npm start # 生产模式
默认监听 http://localhost:3000/mcp，可用 PORT 环境变量改端口。
注册到Claude Code
先确保server已经在跑（见上一步），再注册：
claude mcp add --transport http mcp-starter http://localhost:3000/mcp
注册后，工具会以 mcp__mcp-starter__<tool_name> 的形式出现在agent可用工具列表里。因为是共用同一个server进程，不同agent/session看到的notes/kb数据是同一份。
工具列表
| 工具 | 类别 | 说明 |
|---|---|---|
get_current_time |
通用工具 | 返回当前服务器时间（ISO 8601） |
web_fetch |
通用工具 | 抓取URL，返回去除HTML标签的纯文本 |
notes_add |
笔记 | 新增一条笔记（标题+内容） |
notes_list |
笔记 | 列出所有笔记 |
notes_delete |
笔记 | 按id删除笔记 |
kb_add_document |
知识库 | 存入一段文本（可带tags/source） |
kb_search |
知识库 | 关键词检索知识库 |
数据持久化到 data/notes.json 和 data/kb.json（已gitignore，首次写入时自动创建）。
手动验证清单
- 调用
get_current_time—— 确认MCP链路连通 notes_add后notes_list—— 确认笔记持久化kb_add_document后用匹配关键词kb_search—— 确认检索生效web_fetch一个真实URL —— 确认外部抓取正常
单元测试
npm test
测试文件在 test/，覆盖 fileStore、utility、notes、kb 里的纯逻辑函数；MCP服务器接入本身通过上面的手动验证清单确认。
