maimemo-mcp
maimemo-mcp
Maimemo学習データ用の個人用読み取り専用MCPサーバー。
機能
ローカルMCPクライアント用の
stdioトランスポート。/mcpでのストリーミング可能なHTTPトランスポート。4つの読み取り専用ツール:
maimemo_get_today_progressmaimemo_list_today_wordsmaimemo_get_due_wordsmaimemo_find_vocabularymaimemo_list_notepadsmaimemo_get_notepad
Maimemo OpenAPIリクエスト用のBearer認証。
Maimemoの規定制限(
20/10s、40/60s、2000/5h)に対するローカルのローリングウィンドウレート制限。HTTPトランスポート用のホスト、オリジン、およびオプションのBearerトークン保護。
インストール
npm install
npm run buildNode.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形式を受け付けます。これらはMaimemoを呼び出す前に 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