local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Allows interaction with Redis databases, including creating new databases, running Redis commands, listing databases, managing backups, and viewing usage statistics.
Integrates with Upstash Developer API to manage Upstash resources through natural language commands, such as creating databases, listing resources, running commands, and viewing metrics.

업스타시 MCP 서버

모델 컨텍스트 프로토콜(MCP)은 대규모 언어 모델(LLM)과 외부 시스템 간의 컨텍스트를 관리하기 위한 새로운 표준화된 프로토콜 입니다. 이 저장소에서는 Upstash Developer API를 위한 설치 프로그램과 MCP 서버를 제공합니다.

이를 통해 모든 MCP 클라이언트를 사용하여 자연어를 사용하여 Upstash 계정과 상호 작용할 수 있습니다.예:

"us-east-1에 새로운 Redis 데이터베이스를 생성하세요"
"내 데이터베이스 나열"
users-db에서 "user:"로 시작하는 키 나열
"백업을 만드세요"
"지난 7일 동안 처리량의 급증을 알려주세요"

용법

요구 사항

Node.js >= v18.0.0
Upstash API 키 - 여기 에서 만들 수 있습니다.

지역적으로 사용하는 방법

Claude Desktop 설치

Smithery를 통해 Claude Desktop용 Upstash MCP 서버를 자동으로 설치하려면 다음 명령을 실행하세요.

지엑스피1

npx @upstash/mcp-server init <UPSTASH_EMAIL> <UPSTASH_API_KEY>

이렇게 하면 MCP 구성 파일이 편집되고 Upstash에 대한 항목이 추가됩니다.

커서 설치

Smithery를 통해 Cursor용 Upstash MCP 서버를 자동으로 설치하려면 다음 명령을 실행하세요.

npx -y @smithery/cli@latest install @upstash/mcp-server --client cursor

Cursor의 MCP 설정에 다음 명령을 추가하세요. 자세한 내용은 Cursor MCP 문서를 참조하세요.

npx -y @upstash/mcp-server run <UPSTASH_EMAIL> <UPSTASH_API_KEY>

Windsurf 설치

Smithery를 통해 Windsurf용 Upstash MCP 서버를 자동으로 설치하려면 다음 명령을 실행하세요.

npx -y @smithery/cli@latest install @upstash/mcp-server --client windsurf

Windsurf의 MCP 설정에 다음 명령을 추가하세요. 자세한 내용은 Windsurf MCP 문서를 참조하세요.

npx -y @upstash/mcp-server run <UPSTASH_EMAIL> <UPSTASH_API_KEY>

Docker로 실행

제공된 Docker 이미지를 사용하여 서버를 실행할 수도 있습니다.

docker build -t upstash-mcp .

# Run the stdio server, add this command to you MCP config
docker run --rm -i \
  -e UPSTASH_EMAIL=<UPSTASH_EMAIL> \
  -e UPSTASH_API_KEY=<UPSTASH_API_KEY> \
  upstash-mcp

문제 해결

일반적인 문제

셸과 시스템 PATH 의 차이로 인해 mcp 클라이언트가 올바른 바이너리를 찾는 데 어려움을 겪을 수 있습니다.

이 문제를 해결하려면 셸에서 which npx 또는 which docker 실행하여 바이너리의 전체 경로를 가져온 다음 MCP 구성에서 npx 또는 docker 명령을 전체 바이너리 경로로 바꾸면 됩니다.

노드 버전 관리자

nvm이나 fnm 같은 노드 버전 관리자를 사용 중이라면 이 문제를 확인해 보세요. MCP 설정에서 node 명령을 노드 바이너리의 절대 경로로 변경해야 합니다.

추가 문제 해결

MCP 설명서의 문제 해결 가이드를 참조하세요. Discord를 통해 문의하실 수도 있습니다.

도구

레디스

redis_database_create_backup
redis_database_create_new
redis_database_delete
redis_database_delete_backup
redis_database_get_details
redis_database_list_backups
redis_database_list_databases
redis_database_reset_password
redis_database_restore_backup
redis_database_run_multiple_redis_commands
redis_database_run_single_redis_command
redis_database_set_daily_backup
redis_database_update_regions
redis_database_get_usage_last_5_days
redis_database_get_stats

개발

프로젝트를 복제하고 실행합니다.

pnpm install
pnpm run watch

이렇게 하면 프로젝트가 지속적으로 구축되고 변경 사항이 모니터링됩니다.

테스트를 위해 프로젝트와 같은 디렉토리에 다음 내용이 포함된 .env 파일을 만들 수 있습니다.

UPSTASH_EMAIL=<UPSTASH_EMAIL>
UPSTASH_API_KEY=<UPSTASH_API_KEY>

이는 Claude 구성을 설정하고 mcp inspector를 실행하는 데 사용됩니다.

Claude Desktop으로 테스트

로컬 개발을 위해 Claude Desktop 구성을 설치하려면 다음 명령을 실행하세요.

pnpm run setup

이렇게 하면 패키지의 로컬 빌드를 가리키는 upstash 항목이 MCP 구성 파일에 추가됩니다.

{
  "upstash": {
    "command": "node",
    "args": ["<path-to-repo>/dist/index.js", "run", "<UPSTASH_EMAIL>", "<UPSTASH_API_KEY>"]
  }
}

참고: 노드 버전 관리자와 동일한 문제가 여기에도 적용됩니다. 노드 버전 관리자를 사용하는 경우 사용 섹션의 참고 사항을 확인하세요.

이제 Claude Desktop을 사용하여 Upstash 명령을 실행할 수 있습니다.

MCP 서버의 로그를 실시간으로 보려면 다음 명령을 실행하세요.

pnpm run logs

MCP Inspector로 테스트

MCP Inspector를 사용하여 도구를 테스트할 수도 있습니다.

pnpm run inspector

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

모델 컨텍스트 프로토콜(MCP)은 대규모 언어 모델(LLM)과 외부 시스템 간의 컨텍스트를 관리하기 위한 새로운 표준화된 프로토콜입니다. 이 저장소에서는 Upstash 개발자 API를 위한 설치 프로그램과 MCP 서버를 제공합니다.

Usage

Related Resources

Reddit Discussion about this server

Upstash MCP Server