glif-mcp-서버

glif.app에서 AI 워크플로를 실행하기 위한 MCP 서버입니다.

이 서버는 MCP(Model Context Protocol)를 통해 glif를 실행하고, 봇을 관리하고, glif 메타데이터에 액세스하기 위한 도구를 제공합니다.

이 서버는 add-tool, remove-tool 등의 메타 도구를 통해 사용 가능한 모든 도구를 사용자 지정할 수 있도록 허용하며, 여기에는 도구 세트(및 개성)로 제공되는 전체 GLIF 에이전트도 포함됩니다. 이는 매우 실험적인 작업입니다.

자세한 내용은 https://glif.app 에서 확인하거나 Discord 서버에 가입하세요: https://discord.gg/glif

특징

• 입력을 사용하여 glifs 실행
• glif, 실행 및 사용자에 대한 자세한 정보를 얻으세요
• URI 기반 리소스를 통해 glif 메타데이터에 액세스

설정

npx를 통해 실행(권장)

Node.js가 설치되어 있다면 npx를 통해 @glifxyz/glif-mcp-server 패키지를 실행할 수 있습니다.

1. https://glif.app/settings/api-tokens 에서 API 토큰을 받으세요.
2. Claude Desktop 설정 파일에 서버를 추가하세요. macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json 입니다.지엑스피1

지역 체크아웃에서 실행

먼저, 이 코드를 체크아웃하고 종속성을 설치합니다.

그런 다음 MCP 클라이언트(예: Claude Desktop)를 구성하여 디스크에서 이 서버를 로드합니다.

서버 시작 시 자동으로 로드될 glifs ID(쉼표로 구분)를 지정할 수도 있습니다. 이는 테스트하거나 미리 만들어진 glif 설정을 다른 사람과 공유하려는 경우에 유용합니다.

Smithery로 원격으로 실행

Smithery를 통해 Claude Desktop용 glif-mcp를 자동으로 설치하려면 다음을 수행합니다. Smithery는 사용자를 위해 MCP 서버를 호스팅하고 실행합니다.

사용 제한

• 사용자 계정과 동일한 제한이 적용됩니다.
• https://glif.app/pricing 에서 더 많은 크레딧을 구매하세요

자원

• glif://{id} - glif 메타데이터 가져오기
• glifRun://{id} - 실행 세부 정보 가져오기
• glifUser://{id} - 사용자 프로필 가져오기

도구

일반 Glif 도구

• run_glif - 지정된 ID와 입력으로 glif를 실행합니다.
• glif_info - 입력 필드를 포함한 glif에 대한 자세한 정보를 가져옵니다.
• list_featured_glifs - 추천 glif의 큐레이션된 목록을 받으세요
• search_glifs - 이름이나 설명으로 glif 검색

봇 도구

• list_bots - 추천 봇 및 시뮬레이션 템플릿 목록을 가져옵니다.
• load_bot - 특정 봇에 대한 자세한 정보(기술 포함)를 가져옵니다.
• save_bot_skills_as_tools - 봇의 모든 스킬을 개별 도구로 저장합니다.

사용자별 도구

• my_glifs - glif 목록 가져오기
• my_glif_user_info - 사용자 계정, 최근 glif 및 최근 실행에 대한 자세한 정보를 가져옵니다.

Glif->도구 도구(metatools)

• save_glif_as_tool - glif를 사용자 정의 도구로 저장합니다.
• remove_glif_tool - 저장된 glif 도구 제거
• remove_all_glif_tools - 저장된 모든 glif 도구를 제거하고 원래 상태로 되돌립니다.
• list_saved_glif_tools - 저장된 모든 glif 도구 나열

글리프를 사용자 정의 도구로 전환하는 방법

일반적인 run_glif 도구가 있지만, (a) 설명이 부족하고 (b) 해당 glif를 호출하는 방법을 배우려면 먼저 glif_info 호출해야 합니다. 게다가 glif가 존재한다는 사실도 알아야 합니다.

우리는 특정 글리프를 새로운 독립형 도구로 바꿔주는 몇 가지 새로운 메타 도구를 실험하고 있습니다.

프롬프트 세션의 예:

• 새로운 멋진 글리프는 뭐야?
• [도구 호출: list_featured_glifs ...]
• 좋아, 1970년대 SF 책 표지 생성기를 좋아해요. 그걸 "scifi_book_image"라는 도구로 만들어 주세요.
• [도구호출: save_glif_as_tool glifId=... toolName=scifi_book_image ]
• [이제 사용자는 "Blah의 공상과학 책 이미지 만들기"를 입력하기만 하면 됩니다.]

list_saved_glif_tools 사용하여 이러한 특수 도구를 나열하고 remove_glif_tool 사용하여 원하지 않는 도구를 제거할 수 있습니다.

Claude Desktop은 새 도구 정의를 로드하려면 재시작해야 합니다. Cline과 Cursor는 변경 사항이 있을 때 자동으로 다시 로드되고 사용 가능한 도구를 다시 쿼리하는 것 같습니다.

인증된 사용자의 GLIF에 대한 정보:

• my_glifs - 현재 사용자가 게시한 glif(불필요한 내용 없음)
• my_liked_glifs - 현재 사용자가 좋아하는 glif
• my_runs - 현재 사용자의 공개 실행

개발

종속성 설치:

서버를 빌드하세요:

자동 재빌드를 사용한 개발의 경우:

테스트 모음을 실행하려면:

그리고 변경 사항에 대한 테스트를 지속적으로 실행하려면:

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. MCP Inspector 사용을 권장합니다.

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

Claude Desktop을 사용하는 경우 Claude 로그 디렉터리 내의 glif-mcp 로그를 볼 수도 있습니다.

MCP 레지스트리

개발

새로운 버전을 출시하다

1. package.json 과 src/index.ts 편집하고 버전 번호를 올립니다.
2. npm install 실행하여 잠금 파일에 저장된 버전을 업데이트합니다.
3. 변경 사항을 GitHub에 커밋하고 푸시하고 메인에 병합합니다.
4. gh가 설치되어 있다면 main 모드로 전환하고 npm run release 실행하세요. 그러면 새 버전의 git 태그가 생성되고, 해당 태그를 github에 푸시한 후 gh release create 사용하여 자동 생성된 변경 로그와 함께 새 버전을 게시할 수 있습니다. gh 설치되어 있지 않다면 GitHub 웹 UI에서 위의 작업을 수동으로 수행할 수 있습니다.
5. GitHub Action은 NPM_TOKEN 비밀을 사용하여 NPM에 게시합니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.