mcp-starter
A local MCP server providing general utility tools, persistent note storage, and keyword-searchable knowledge base via Streamable HTTP, enabling multiple agents to share the same data.
README
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服务器接入本身通过上面的手动验证清单确认。
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.
E2B
Using MCP to run code via e2b.