Skip to main content
Glama

maimemo-mcp

Maimemo 학습 데이터를 위한 개인용 읽기 전용 MCP 서버입니다.

기능

  • 로컬 MCP 클라이언트를 위한 stdio 전송.

  • /mcp에서 스트리밍 가능한 HTTP 전송.

  • 6개의 읽기 전용 도구:

    • maimemo_get_today_progress

    • maimemo_list_today_words

    • maimemo_get_due_words

    • maimemo_find_vocabulary

    • maimemo_list_notepads

    • maimemo_get_notepad

  • Maimemo OpenAPI 요청을 위한 Bearer 인증.

  • 문서화된 Maimemo 제한(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_HOST127.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=stdio

MCP 클라이언트 명령 예시:

{
  "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"]
}

statusall, unfinished 또는 finished일 수 있습니다. freshnessall, 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 build
Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - A tier

Resources

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