maimemo-mcp
maimemo-mcp
用于墨墨背单词（Maimemo）学习数据的个人只读 MCP 服务器。
功能特性
支持本地 MCP 客户端的
stdio传输。支持
/mcp路径下的流式 HTTP 传输。提供四个只读工具：
maimemo_get_today_progressmaimemo_list_today_wordsmaimemo_get_due_wordsmaimemo_find_vocabularymaimemo_list_notepadsmaimemo_get_notepad
针对墨墨 OpenAPI 请求的 Bearer 身份验证。
针对墨墨官方限制的本地滑动窗口速率限制：
20/10s、40/60s和2000/5h。针对 HTTP 传输的主机、来源和可选的 Bearer 令牌保护。
安装
npm install
npm run build请使用 Node.js 20 或更高版本。
配置
必需：
export MAIMEMO_TOKEN="your-maimemo-openapi-token"可选：
export MAIMEMO_BASE_URL="https://open.maimemo.com/open"
export MAIMEMO_HTTP_HOST="127.0.0.1"
export MAIMEMO_HTTP_PORT="3333"当 MAIMEMO_HTTP_HOST 不为 127.0.0.1、localhost 或 ::1 时，
必须设置 MCP_SERVER_AUTH_TOKEN：
export MCP_SERVER_AUTH_TOKEN="your-local-mcp-http-token"请勿提交真实的令牌。.env 文件默认已被忽略。
使用 Stdio 运行
MAIMEMO_TOKEN="your-token" npx maimemo-mcp --transport=stdio对于本地检出版本：
MAIMEMO_TOKEN="your-token" node dist/cli.js --transport=stdioMCP 客户端命令示例：
{
"mcpServers": {
"maimemo": {
"command": "node",
"args": ["/absolute/path/to/momo-skills/dist/cli.js", "--transport=stdio"],
"env": {
"MAIMEMO_TOKEN": "your-token"
}
}
}
}使用流式 HTTP 运行
MAIMEMO_TOKEN="your-token" node dist/cli.js --transport=http默认端点：
http://127.0.0.1:3333/mcp对于非回环绑定：
MAIMEMO_TOKEN="your-token" \
MAIMEMO_HTTP_HOST="0.0.0.0" \
MCP_SERVER_AUTH_TOKEN="your-local-mcp-http-token" \
node dist/cli.js --transport=http客户端随后必须发送：
Authorization: Bearer your-local-mcp-http-token工具输入
maimemo_get_today_progress 无输入参数。
maimemo_list_today_words：
{
"status": "all",
"freshness": "all",
"limit": 50,
"spellings": ["hello", "world"]
}status 可以是 all、unfinished 或 finished。
freshness 可以是 all、new 或 review。
limit 必须在 1 到 1000 之间。
maimemo_get_due_words：
{
"startDate": "2026-04-18",
"endDate": "2026-04-20",
"spellings": ["hello"],
"limit": 50,
"countOnly": false
}日期接受 YYYY-MM-DD 或 ISO 时间戳格式。在调用墨墨接口前，它们会被标准化为 Asia/Shanghai 时区。
maimemo_find_vocabulary：
{
"spellings": ["hello"]
}或：
{
"ids": ["vocabulary-id"]
}请提供 spellings 或 ids 中的其中一个。
maimemo_list_notepads：
{
"limit": 20,
"offset": 0,
"ids": ["notepad-id"]
}limit 必须在 1 到 100 之间。
maimemo_get_notepad：
{
"id": "notepad-id"
}返回完整的笔记本内容和解析后的单词列表。
开发
npm test
npm run typecheck
npm run buildResources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/xiandan-erizo/maimemo-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server