Skip to main content
Glama
coreline-ai

Antigravity GLM MCP

by coreline-ai

🚀 Antigravity GLM MCP

Gemini (Antigravity) ⟷ GLM-4.5 모델 브릿지 MCP 서버

복잡한 코딩 작업을 GLM AI에게 위임하고, 25가지 강력한 도구로 자동화하세요.

Python MCP Tools License Security

📖 문서 · ⚡ 빠른 시작 · 🛠️ 도구 · 🛡️ 보안


✨ 왜 이 프로젝트인가요?

문제점

해결책

🐳 복잡한 Docker 설정

Zero-Docker: HTTPS 직접 호출로 즉시 시작

🔐 API 키 유출 우려

보안 강화: 환경변수 필터링, 샌드박스 적용

📁 파일 실수 복구 불가

자동 백업: 수정/삭제 전 버전 관리

🧠 세션 간 정보 손실

영구 메모리: JSON 기반 장기 기억 저장소

⚠️ 위험한 쉘 명령 실행

화이트리스트: 승인된 명령만 허용


Related MCP server: cygnus-ssh-mcp

🏗️ 아키텍처

flowchart LR
    subgraph "🖥️ Gemini Desktop"
        A[Antigravity Agent]
    end
    
    subgraph "🔧 MCP Server"
        B[antigravity_glm_mcp]
        C[25 Tools]
        D[Security Layer]
    end
    
    subgraph "☁️ Cloud APIs"
        E[GLM-4.5 API]
        F[Web Search]
    end
    
    subgraph "💾 Local Storage"
        G[Files & Git]
        H[Memory DB]
        I[Backups]
    end

    A <--> |MCP Protocol| B
    B --> C
    C --> D
    D --> E
    D --> F
    D --> G
    D --> H
    D --> I

📖 문서

📄 문서

🔍 설명

🏛️ 아키텍처

시스템 설계, 보안 계층, 통신 흐름 상세

📚 도구 레퍼런스

25개 도구 파라미터 및 응답 명세

⚡ 퀵스타트

5분 설치 가이드 및 첫 사용 예제


⚡ 빠른 시작 (5분)

📋 사전 요구사항

  • Python 3.11+ (가상환경 권장)

  • Zhipu AI API 키 또는 호환 엔드포인트

🚀 설치 방법

# 1. 저장소 클론
git clone https://github.com/coreline-ai/antigravity_glm_mcp.git
cd antigravity_glm_mcp

# 2. 가상환경 생성 및 활성화
python3.11 -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# 3. 자동 설치 (권장)
python scripts/install.py
# 의존성 설치
pip install -r requirements.txt

# MCP 설정 파일에 추가 (~/.gemini/settings.json 등)
{
  "mcpServers": {
    "antigravity_glm_mcp": {
      "command": "/path/to/.venv/bin/python",
      "args": ["/path/to/antigravity_glm_mcp/src/server.py"],
      "env": {
        "PROJECT_ROOT": "/your/workspace",
        "ZHIPU_API_KEY": "your-api-key",
        "GLM_MODEL": "GLM-4.5",
        "GLM_BASE_URL": "https://api.z.ai/api/coding/paas/v4",
        "PYTHONPATH": "/path/to/antigravity_glm_mcp"
      }
    }
  }
}

🛠️ 전체 도구 목록 (25개)

🧠 지능 위임 (Intelligence Delegation)

도구

설명

주요 파라미터

glm_cmd

GLM에 복잡한 작업 위임

task_description, context

glm_bypass

원시 프롬프트 직접 전송

prompt

glm_image_analyze

이미지 분석 (Vision)

image_path, prompt

📁 파일 시스템 (File System)

도구

설명

주요 파라미터

glm_file_read

파일 내용 읽기

path, encoding

glm_file_create

새 파일 생성

path, content, overwrite

glm_file_edit

문자열 치환 수정

path, old_string, new_string

glm_file_delete

파일 삭제 (백업 보관)

path

glm_file_rollback

이전 버전 복원

path, version

glm_dir_list

디렉토리 목록

path, recursive

glm_grep

정규식 파일 검색

pattern, path, case_sensitive

💻 코드 실행 (Code Execution)

도구

설명

주요 파라미터

glm_code_run

Python 샌드박스 실행

code, timeout

glm_shell_exec

화이트리스트 쉘 실행

command, cwd

🌿 Git 협업 (Git Collaboration)

도구

설명

주요 파라미터

glm_git_status

저장소 상태 조회

repo_path

glm_git_commit

변경사항 커밋

message, add_all

glm_git_log

커밋 이력 조회

n, oneline

glm_git_diff

변경사항 비교

stat_only, commit

🌐 네트워크 (Network)

도구

설명

주요 파라미터

glm_http_request

HTTP 요청 (SSRF 방지)

url, method, body

glm_web_search

DuckDuckGo 웹 검색

query, max_results

🧠 메모리 & 데이터 (Memory & Data)

도구

설명

주요 파라미터

glm_memory_save

장기 메모리 저장

key, value, category

glm_memory_get

메모리 조회

key

glm_memory_list

전체 메모리 목록

category, limit

glm_memory_delete

메모리 삭제

key

glm_db_query

SQLite 쿼리 실행

query, db_path, read_only

📊 관리 & 로깅 (Management)

도구

설명

주요 파라미터

glm_schedule_task

작업 예약 (Cron)

action, cron, command

glm_action_log

에이전트 활동 로그

limit, action_filter


🛡️ 보안 아키텍처

이 프로젝트는 4단계 보안 계층을 구현합니다:

flowchart TB
    subgraph "Layer 1: Sandbox"
        A[PROJECT_ROOT 경로 검증]
    end
    
    subgraph "Layer 2: Network"
        B[SSRF 방지 - 내부망 IP 차단]
        C[DNS Rebinding 방어]
    end
    
    subgraph "Layer 3: Execution"
        D[RCE 방지 - 환경변수 필터링]
        E[쉘 화이트리스트]
    end
    
    subgraph "Layer 4: Data"
        F[자동 백업]
        G[API 키 격리]
    end
    
    A --> B --> D --> F

보호 대상

위협

방어 조치

파일 시스템

Path Traversal

PROJECT_ROOT 외부 접근 차단

네트워크

SSRF 공격

내부망 IP(10.x, 172.x, 192.168.x) 필터링

코드 실행

RCE / 키 유출

ZHIPU_API_KEY 등 민감 환경변수 차단

쉘 명령

시스템 파괴

rm -rf, sudo 등 위험 명령 차단

WARNING

glm_shell_exec화이트리스트에 등록된 안전한 명령만 실행합니다. rm, sudo, chmod 777 등은 원천 차단됩니다.


🔧 환경변수 설정

변수명

필수

설명

기본값

ZHIPU_API_KEY

GLM API 인증 키

-

PROJECT_ROOT

작업 대상 디렉토리

현재 디렉토리

GLM_MODEL

사용할 모델

glm-4-plus

GLM_BASE_URL

API 엔드포인트

https://open.bigmodel.cn/api/paas/v4

GLM_TIMEOUT

요청 타임아웃 (초)

120


📂 프로젝트 구조

antigravity_glm_mcp/
├── 📄 README.md                 # 이 문서
├── 📄 requirements.txt          # Python 의존성
├── 📄 pyproject.toml            # 패키지 메타데이터
│
├── 📁 src/                      # 소스 코드
│   ├── server.py                # MCP 서버 진입점
│   ├── models.py                # 공통 모델 (ToolResponse 등)
│   │
│   ├── 📁 core/                 # 핵심 인프라
│   │   ├── config.py            # 설정 관리자
│   │   ├── glm_client.py        # GLM API 클라이언트
│   │   ├── sandbox.py           # 경로 보안 검증
│   │   └── backup.py            # 자동 백업 시스템
│   │
│   └── 📁 tools/                # 25개 도구 구현
│       ├── glm_cmd.py           # 지능 위임 (cmd, bypass)
│       ├── file_ops.py          # 파일 CRUD
│       ├── dir_ops.py           # 디렉토리 작업
│       ├── grep_ops.py          # 파일 검색
│       ├── code_ops.py          # 코드 실행
│       ├── shell_ops.py         # 쉘 실행
│       ├── git_ops.py           # Git 협업
│       ├── http_ops.py          # HTTP 요청
│       ├── web_ops.py           # 웹 검색
│       ├── db_ops.py            # DB 쿼리
│       ├── memory_ops.py        # 메모리 관리
│       ├── image_ops.py         # 이미지 분석
│       ├── schedule_ops.py      # 작업 예약
│       └── reporting.py         # 로그 관리
│
├── 📁 scripts/                  # 유틸리티 스크립트
│   └── install.py               # 자동 설치 스크립트
│
├── 📁 docs/                     # 문서
│   ├── ARCHITECTURE.md          # 아키텍처 상세
│   ├── TOOLS.md                 # 도구 레퍼런스
│   └── QUICKSTART.md            # 빠른 시작 가이드
│
├── 📁 tests/                    # 테스트 코드
│   ├── local_tools_test.py      # 로컬 도구 통합 테스트
│   └── simple_test.py           # 지능 도구 테스트
│
└── 📁 data/                     # 런타임 데이터 (Git 제외)
    ├── memory/                  # 영구 메모리 저장소
    └── action_logs.jsonl        # 에이전트 활동 로그

🧪 테스트

# 가상환경 활성화 후

# 1. .env 파일 생성 (권장)
cp .env.sample .env
# .env 파일을 열어 ZHIPU_API_KEY를 입력하세요.

# 2. 로컬 도구 테스트 (API 키 불필요)
./.venv/bin/python tests/local_tools_test.py

# 3. 지능 도구 테스트 (API 키 필요)
# .env 파일이 없다면 직접 export 하세요.
export ZHIPU_API_KEY="your-key" 
./.venv/bin/python tests/simple_test.py

📜 라이선스

이 프로젝트는 MIT License 하에 배포됩니다. 자유롭게 사용, 수정, 배포하실 수 있습니다.


Made with ❤️ for Gemini × GLM Collaboration

GitHub stars

Available Tools

25 tools
glm_action_logC

작업 로그 조회.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNo조회할 로그 개수
offsetNo시작 오프셋
action_filterNo액션 타입 필터

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, and the description does not disclose any behavioral traits such as being read-only, pagination behavior, or performance characteristics. It only states the basic operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single short sentence with no wasted words, but being overly concise may omit necessary context.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema and no annotations, the description fails to explain return values, pagination, or how to use the parameters effectively. The tool has 3 parameters but the description provides no context beyond the name.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with parameter descriptions already present. The description adds no additional meaning beyond what the schema provides, so baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description '작업 로그 조회.' (view action log) clearly states the verb and resource. However, among many sibling tools like glm_git_log and glm_memory_list, it does not differentiate itself explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives, no context on prerequisites or limitations.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_bypassC

GLM에 원시 프롬프트를 직접 보냅니다. (Raw Mode)

ParametersJSON Schema
NameRequiredDescriptionDefault
promptYesGLM에게 보낼 원시 프롬프트

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, and the description fails to disclose behavioral traits such as safety implications, output format, side effects, or rate limits. The term 'Raw Mode' hints at no preprocessing but is not elaborated.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence with no wasted words, and it is front-loaded with the tool's core purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite having only one parameter and no output schema, the description lacks behavioral context and usage guidance, making it insufficient for an agent to use safely and effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

100% schema coverage means the schema already documents the parameter. The description adds no extra meaning beyond the parameter's description, missing opportunities to specify format, length, or constraints.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it sends a raw prompt directly to GLM, indicating a specific mode. However, it does not explain what 'raw' means in context, which could cause ambiguity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives like glm_cmd. The description implies use when a raw prompt is needed but lacks explicit instructions or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_cmdC

GLM-4-plus에 질문을 위임합니다. (지능)

ParametersJSON Schema
NameRequiredDescriptionDefault
task_descriptionYesGLM에게 위임할 작업 설명
contextNo추가 컨텍스트 (코드, 파일 내용 등)
working_dirNo작업 디렉토리 경로

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, and the description does not disclose behavioral traits such as side effects, required permissions, or rate limits. It only states the basic action without safety or operational context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence that efficiently communicates the core function, though it could benefit from additional detail without becoming verbose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the absence of annotations and output schema, the description is insufficient. It does not explain return values, error handling, or constraints, leaving the agent with limited decision-making information.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with descriptions for each parameter. The tool description adds minimal value beyond the schema, merely restating the purpose without elaborating on parameter usage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool delegates questions to GLM-4-plus, distinguishing it from sibling tools that perform specific actions like file operations or code execution.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives like glm_bypass or other delegation methods. The description lacks context on appropriate use cases.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_code_runB

Python 코드 실행 (샌드박스).

ParametersJSON Schema
NameRequiredDescriptionDefault
codeYes실행할 Python 코드
timeoutNo실행 제한 시간 (초, 기본 10초)

TDQS

B3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description mentions 'sandbox' but does not elaborate on behavioral constraints (e.g., file access, network, error handling). With no annotations, the description fails to disclose what happens during execution or return format.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise (3 words) but lacks structure. It adequately conveys the basic purpose but omits critical details, making it too minimal for a code execution tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (code execution, no output schema, no annotations), the description is insufficient. It does not cover return values, error handling, or sandbox limitations, leaving significant gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with clear descriptions for both parameters. The description adds no extra meaning, but the schema already provides adequate semantics. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Python 코드 실행 (샌드박스)' clearly states the tool's purpose: executing Python code in a sandboxed environment. It distinguishes from siblings like glm_shell_exec (general shell execution).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No usage guidelines provided. The description does not indicate when to use this tool over alternatives like glm_shell_exec or mention prerequisites or limitations.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_db_queryD

DB 쿼리 (SQLite).

ParametersJSON Schema
NameRequiredDescriptionDefault
db_pathNoSQLite DB 파일 경로data/app.db
queryYesSQL 쿼리문
paramsNo쿼리 파라미터 (?)
read_onlyNo읽기 전용 모드 여부

TDQS

D1.7/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must fully disclose behavior, but it fails to mention that the tool can execute arbitrary SQL, potentially modifying data when read_only is false. No safety or side-effect information is given.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise but under-specified. It is not structured with full sentences and fails to convey essential information, sacrificing completeness for brevity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given four parameters and no output schema, the description is woefully incomplete. It does not explain the tool's behavior (e.g., execution results, error handling, or the significance of read_only).

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The tool description adds no additional value beyond the schema's parameter descriptions, but it does not detract.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'DB 쿼리 (SQLite)' is a tautology of the tool's name 'glm_db_query' and specifies the database type but lacks a verb or clear action. It does not distinguish from sibling tools like glm_memory_get or glm_file_read.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives, such as for data retrieval versus modification, or when to use read_only mode. The description offers no usage context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_dir_listC

디렉토리 목록 조회.

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYes조회할 디렉토리 경로 (상대 경로 또는 절대 경로)
recursiveNo하위 디렉토리까지 재귀적으로 조회 여부 (현재는 1단계만 지원)
only_directoriesNo디렉토리만 조회 여부

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, and the description does not disclose behavioral traits such as read-only nature, performance implications, or error handling. The parameter description mentions '1단계만 지원' but the tool description itself is silent.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is very concise (one sentence). It is front-loaded with the purpose. However, it is too terse and lacks structure; adding a brief note on behavior would improve without sacrificing conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the absence of an output schema and annotations, the description should provide more context about return format, side effects, or limitations. The tool is simple, but the description does not confirm it is read-only or explain recursion constraints beyond the schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Input schema has 100% parameter description coverage, so baseline is 3. The description adds no additional meaning beyond the schema; it does not explain the purpose of each parameter or provide usage examples.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action: '디렉토리 목록 조회' (list directory contents). It is specific and distinguishes from sibling tools, as no other tool lists directories. However, it could be more explicit about scope (e.g., files and subdirectories).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives. The description does not mention prerequisites, limitations, or context where other tools (e.g., file_read) would be more appropriate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_file_createB

새 파일을 생성합니다.

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYes생성할 파일 경로
contentYes파일 내용
overwriteNo기존 파일 덮어쓰기 허용 여부
encodingNo파일 인코딩utf-8

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description bears full responsibility for behavioral disclosure. It only states that a file is created, leaving out key behaviors such as what happens if the file exists (overwrite defaults to false, but this is not mentioned) or encoding details.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence. It is concise but could be slightly expanded to include more context without becoming verbose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 4 parameters and no output schema, the description lacks completeness. It does not explain what the tool returns, error conditions, or behavior for edge cases like existing files.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

All 4 parameters are described in the input schema (100% coverage), so the baseline is 3. The description adds no extra meaning beyond 'create a new file,' which does not enhance the schema's parameter documentation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states 'Create a new file,' which is a specific verb and resource. This distinguishes it from sibling tools like glm_file_delete, glm_file_edit, and glm_file_read, which have different actions.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives, nor are there any prerequisites or conditions for usage. The agent must infer the use case from the name and parameters.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_file_deleteB

파일을 삭제합니다 (백업 보관).

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYes삭제할 파일 경로

TDQS

B3.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the burden. It mentions that deletion includes a backup archive, which is a notable behavioral trait. However, it does not clarify if the backup is automatic, how to restore, or if the deletion is reversible, leaving significant gaps.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no extraneous words. It efficiently conveys the core purpose without wasted space.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple one-parameter delete tool, the description provides the basic action but lacks details on error handling, success indicators, and the backup mechanism. Without an output schema, more context would be beneficial for agent decision-making.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema covers the single parameter 'path' with 100% description coverage. The tool description adds no additional meaning beyond the schema, so baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states 'Deletes the file (backup archive)', clearly indicating the verb and resource. It distinguishes from sibling tools like read, create, edit, and rollback. However, the backup nuance is ambiguous, slightly reducing clarity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives, nor any prerequisites or warnings. Siblings like glm_file_rollback exist but are not mentioned, leaving the agent without context for selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_file_editB

파일을 수정합니다 (문자열 교체).

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYes수정할 파일 경로
old_stringYes찾을 문자열
new_stringYes바꿀 문자열

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, and the description only states 'string replacement' without disclosing behavioral traits such as whether the modification is in-place, destructive, or reversible. Information about backup or safety is missing.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence, highly concise and front-loaded. Every word serves a purpose, making it efficient for quick understanding.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema and only a one-line description, the tool lacks information on return values, error handling, and behavior when the string is not found. For a modification tool, completeness is insufficient.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with basic descriptions for all parameters. However, these descriptions add minimal value beyond parameter names. Baseline score of 3 is appropriate given high coverage, though descriptions are sparse.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'modifies' and resource 'file', with the specific operation 'string replacement'. It effectively distinguishes from sibling tools like file_read, file_create, and file_delete.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives (e.g., glm_file_create or glm_file_rollback). The description lacks any context for appropriate usage or prerequisites.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_file_readC

파일 내용을 읽습니다.

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYes읽을 파일 경로
encodingNo파일 인코딩 (기본: utf-8)utf-8

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. It discloses no behavioral traits: no mention of size limits, binary vs text, error handling, permissions, or side effects. Agent lacks critical information.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Description is a single sentence, concise and front-loaded. However, it under-specifies behavior, but conciseness itself is appropriate for a simple tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema and no annotations, the description is too sparse. It fails to inform about return format, potential errors, or usage constraints, making it incomplete for an agent to use reliably.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents both parameters. The description adds no additional meaning beyond the schema, meeting baseline but not enhancing understanding.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description '파일 내용을 읽습니다.' clearly states the tool reads file content, which is a specific verb+resource. It distinguishes from sibling tools like create, edit, delete, but lacks explicit contrast with similar tools like glm_dir_list.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use vs alternatives. No mention of context where this tool is appropriate or not, leaving the agent without decision support.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_file_rollbackC

파일을 복원합니다.

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYes복원할 파일 경로
versionNo복원할 버전 (-1: 최신)

TDQS

C2.2/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. The single sentence discloses no behavioral traits such as reversibility, permission requirements, or side effects (e.g., overwriting current file). This is severely inadequate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is excessively short (one sentence) and lacks structure. While concise, it under-specifies critical information, making it less helpful for an AI agent.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has two parameters and no output schema or annotations, the description should provide more context. It fails to explain return values, default behavior of version=-1, or error conditions, leaving the agent with insufficient information.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with descriptions for both parameters (path and version) in Korean. The tool description '파일을 복원합니다' adds no additional meaning beyond the schema, so baseline score of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description '파일을 복원합니다' (restores a file) states the action and resource, but lacks specificity about what 'restore' entails (e.g., from version history, backup). It is better than a tautology but does not distinguish from sibling file operations like glm_file_edit or glm_file_read.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives such as glm_file_create or glm_file_edit. The description provides no context for appropriate usage, exclusions, or prerequisites.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_git_commitD

Git 커밋.

ParametersJSON Schema
NameRequiredDescriptionDefault
messageYes커밋 메시지
add_allNo커밋 전 모든 변경사항 스테이징 여부 (git add -A)
repo_pathNo저장소 경로 (기본값: 현재 프로젝트 루트)

TDQS

D1.4/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, and the description does not mention that the tool creates a commit (a mutation). It fails to disclose side effects, required permissions, or any behavioral characteristics.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise (two Korean words) but under-specified. While brevity is good, it sacrifices clarity and completeness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 3 parameters, no output schema, and no annotations, the description is severely incomplete. It does not explain return values, behavior, or how it fits into the git workflow.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents the parameters. The description adds no additional parameter semantics beyond what is in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Git 커밋.' is a tautology of the tool name 'glm_git_commit'. It provides no additional information about what the tool does beyond restating its name.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to use this tool versus alternatives like glm_git_diff, glm_git_log, or glm_git_status. The description offers no context for appropriate usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_git_diffB

Git 변경 사항 비교.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNo비교 대상 (예: 'HEAD~1', 'main', 커밋 해시). 미지정 시 스테이징 변경사항 표시
file_pathNo특정 파일만 비교 (옵션)
stat_onlyNo변경 통계만 표시
repo_pathNo저장소 경로 (기본값: 현재 프로젝트 루트)

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, and the description does not disclose any behavioral traits (e.g., read-only, destructive). The agent cannot infer if this operation is safe or has side effects from the description alone.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely short (one phrase), which is concise and front-loaded. However, it could include more structure without losing conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the 4 parameters with full schema descriptions and no output schema, the description should at least mention what the output looks like (e.g., diff format). The lone phrase is insufficient for full context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so baseline is 3. The description adds no additional meaning beyond the schema; it merely states the tool's purpose. The parameter details are fully documented in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Git 변경 사항 비교.' (Compare Git changes.) clearly states the tool's action and resource. It effectively distinguishes this tool from sibling git tools like commit, log, and status.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool vs alternatives such as glm_git_log or glm_git_status. The description lacks any when-to-use or when-not-to-use information.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_git_logC

Git 커밋 이력 조회.

ParametersJSON Schema
NameRequiredDescriptionDefault
nNo조회할 커밋 수 (기본값: 10)
onelineNo한 줄 요약 형식
repo_pathNo저장소 경로 (기본값: 현재 프로젝트 루트)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description must fully disclose behavior. It only says 'inquiry', implying read-only but does not explicitly state non-destructive nature, limits, or output characteristics. Insufficient for safe invocation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

One sentence, concise and to the point. No wasted words. However, could benefit from slightly more detail without becoming verbose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Missing description of return value format or fields, which is important since there is no output schema. Also no usage context. Incomplete for an agent to fully understand the tool's output and behavior.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Input schema has 100% description coverage; the description adds no additional meaning beyond the schema. Baseline score of 3 is appropriate since schema already explains parameters adequately.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states 'Git commit history inquiry', which is specific and aligns with the tool name. However, it does not differentiate from sibling tools like glm_git_diff or glm_git_status, missing a chance to clarify its unique role.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives (e.g., git_diff, git_status). Lacks context for an AI agent to choose correctly among sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_git_statusB

Git 상태 조회.

ParametersJSON Schema
NameRequiredDescriptionDefault
repo_pathNo저장소 경로 (기본값: 현재 프로젝트 루트)

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, and the description does not disclose behavioral traits. It does not state whether the tool is read-only, what it returns (e.g., full status output), or any side effects. The input schema partially compensates by describing the repo_path parameter, but the description itself adds no behavioral context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence (in Korean) that is concise and front-loaded with the tool's action. It wastes no words but is arguably too terse, lacking structure for further details. For a simple tool, this conciseness is acceptable, though minimal.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the simplicity of the tool and lack of output schema, the description is incomplete. It does not explain what the output looks like (e.g., branch, modified files, untracked files) or any nuances (e.g., whether it shows stashed changes). The single line fails to provide enough context for an AI agent to fully understand the tool's behavior.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% for the single optional parameter 'repo_path', which already describes its meaning (path with default set to current project root). The main description does not add information beyond the schema, earning a baseline score of 3. No param details are missing that the description could provide.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Git 상태 조회' (View Git status) clearly indicates the tool's function: querying the Git status of a repository. It uses a specific verb-resource combination that distinguishes it from sibling tools like glm_git_commit (commit), glm_git_diff (diff), and glm_git_log (log).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It does not mention prerequisites (e.g., must be in a Git repository), typical use cases, or scenarios where it should be avoided. The one-line translation offers only the basic action without context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_grepC

파일 내용 검색 (grep).

ParametersJSON Schema
NameRequiredDescriptionDefault
patternYes검색할 패턴 (문자열 또는 정규식)
pathNo검색 시작 경로 (기본값: 프로젝트 루트).
recursiveNo하위 디렉토리까지 재귀 검색
file_patternNo파일 필터 (예: '*.py', '*.js')
case_sensitiveNo대소문자 구분
max_resultsNo최대 결과 수 (성능 보호)
context_linesNo매칭 라인 전후 컨텍스트 라인 수

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description bears full responsibility. It only states 'search', implying a read-only operation, but does not explicitly disclose behavioral traits such as non-destructiveness, permission requirements, or performance characteristics.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise at just three words in Korean (translated to English: 'Search file contents (grep)'). It is front-loaded with the purpose, but may be too minimal to provide full context.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 7 parameters and no output schema, the description should cover return format and behavioral context. It does not mention output, performance, or limitations, leaving gaps for an AI agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The tool description itself adds no additional parameter information beyond what the schema provides.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states 'Search file contents (grep)', which is a specific verb and resource. It distinguishes from sibling tools that perform different actions like database queries or web searches, though it does not explicitly mention alternatives.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It does not mention any prerequisites, exclusions, or context for usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_http_requestD

HTTP 요청.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlYes요청 URL
methodNoHTTP 메소드 (GET, POST, PUT, DELETE)GET
headersNoHTTP 헤더
bodyNo요청 본문 (JSON 데이터 등)
timeoutNo타임아웃 (초)

TDQS

D1.9/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must disclose behavioral traits like authentication, side effects, or rate limits, but it contains none. The one-word description is completely insufficient.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Extremely brief but under-specified; it is not concise but rather incomplete. Every sentence should earn its place, but this single word fails to inform.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 5 parameters and no output schema, the description is severely lacking. It omits return format, error behavior, and any contextual details needed for correct invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema covers all 5 parameters with descriptions, so the tool description does not need to add param details. Baseline 3 applies; no extra value added.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'HTTP 요청' merely restates the tool name, offering no additional specifics. It lacks a verb and does not distinguish this HTTP request tool from other siblings like web search or shell commands.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives such as glm_web_search or glm_shell_exec. There is no mention of use cases, prerequisites, or contexts.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_image_analyzeC

이미지 분석 (Vision).

ParametersJSON Schema
NameRequiredDescriptionDefault
image_pathYes분석할 이미지 경로
promptNo분석 요청 프롬프트Describe this image

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description should disclose behavioral traits like read-only or side effects. It does not specify whether the tool modifies data or requires permissions; only implies analysis.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is very short and to the point. It is concise but not wasteful; however, it could include a bit more context without losing conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (2 params, no output schema), the description should explain what the analysis returns. It does not mention output format or any behavioral details, leaving the agent with incomplete context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already covers both parameter descriptions (100% coverage). The tool description adds no additional meaning beyond the schema, so a baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description '이미지 분석 (Vision)' clearly indicates the tool is for image analysis using vision capabilities. It is specific and matches the tool name, but it does not differentiate from siblings, though no sibling tools directly compete.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus others. The description implies it is for image analysis, but lacks exclusions or alternative suggestions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_memory_deleteD

메모리 삭제.

ParametersJSON Schema
NameRequiredDescriptionDefault
keyYes삭제할 키

TDQS

D1.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavioral traits. It only states 'Memory delete' without clarifying if the deletion is permanent, what side effects occur, or whether it requires confirmation. For a deletion operation, this is insufficient.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely short (two words), which makes it under-specified rather than concise. It fails to efficiently provide necessary usage details, resulting in poor structure.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool is a deletion operation with no output schema or annotations, the description lacks essential context such as behavior on missing keys, permanent effects, and interaction with other memory tools. It is incomplete for an agent to use correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% coverage with a clear description for the 'key' parameter ('삭제할 키' – key to delete). The description adds no extra meaning, but the schema already provides adequate information, meeting the baseline of 3.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description is '메모리 삭제.' which is a tautology of the tool name 'glm_memory_delete'. It restates the name without adding any specific verb or resource details, providing no additional clarity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description offers no guidance on when or when not to use this tool. No mention of alternatives like glm_memory_get or glm_memory_list, nor any context about prerequisites or typical use cases.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_memory_getD

메모리 조회.

ParametersJSON Schema
NameRequiredDescriptionDefault
keyYes메모리 키
categoryNo카테고리 필터

TDQS

D1.9/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, and description offers no behavioral info (e.g., read-only, side effects, permissions). Fails to compensate for missing annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Extremely short but fails to be informative; underspecified for a tool with 2 parameters and no output schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations, no output schema, and two parameters, description lacks essential details like return values, error handling, or usage examples.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema covers 100% of parameters with descriptions; description adds no extra meaning beyond what schema already provides.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description '메모리 조회' (memory query) restates the name without specifying what it retrieves (single by key? list?) or distinguishing from sibling glm_memory_list.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool over alternatives like glm_memory_list or glm_memory_save; lacks context for decision.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_memory_listD

메모리 목록.

ParametersJSON Schema
NameRequiredDescriptionDefault
categoryNo카테고리 필터
limitNo최대 개수

TDQS

D1.7/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are present, and the description provides no behavioral details. There is no mention of what the tool returns, whether results are paginated, or any side effects. The description carries the full burden but fails to disclose anything beyond the name.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise (two words) but at the expense of usefulness. It is under-specified and does not earn its place; more information is needed for effective tool selection.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of output schema, minimal parameters, and no annotations, the description is highly incomplete. It does not explain what the output contains, how to interpret results, or any important constraints like maximum limit.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with descriptions for both parameters (category filter and limit). The tool description adds no additional meaning beyond what the schema already provides, so the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description is '메모리 목록.' which translates to 'Memory list.' It merely restates the tool name without a specific verb or resource, and does not distinguish it from sibling tools like glm_memory_save, glm_memory_get, or glm_memory_delete.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No usage guidance is provided. The description lacks any context about when to use this tool versus its siblings, such as for retrieving a list of saved memories.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_memory_saveC

메모리 저장.

ParametersJSON Schema
NameRequiredDescriptionDefault
keyYes메모리 키
valueYes저장할 값
categoryNo카테고리general
ttl_hoursNo만료 시간 (시간)

TDQS

C2.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description should disclose behavioral traits. It only states 'save', omitting whether it overwrites existing keys, persistence, auth needs, or error handling. The agent lacks crucial context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The single short sentence is concise but lacks substance. It does not earn its place as it merely repeats the name, offering no structure or front-loaded information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 4 parameters and no output schema, the description is completely inadequate. It does not explain return values, side effects, or usage patterns, leaving the agent to guess.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and parameter descriptions are clear (e.g., 'key', 'value'). The tool description adds no new semantic value beyond the schema, so baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description '메모리 저장.' (Memory save) is a tautology that restates the tool name without specifying the resource or context. It fails to distinguish from sibling tools or clarify what 'memory' refers to.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives like glm_memory_update (if exists) or glm_memory_delete. The agent is left to infer usage from the name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_schedule_taskC

작업 예약 관리.

ParametersJSON Schema
NameRequiredDescriptionDefault
actionYes동작: add, list, remove
nameNo작업 이름
cronNocron 표현식 (예: '0 9 * * *')
commandNo실행할 명령어 또는 도구 호출 JSON
task_idNo삭제할 작업 ID

TDQS

C2/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, and the description does not disclose any behavioral traits such as side effects, required permissions, or limits. The tool's behavior (e.g., whether it persists tasks) is entirely opaque.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Extremely short but underspecified; does not provide useful information. True conciseness would preserve clarity, which is missing here.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 5 parameters and no output schema, the description fails to explain the tool's overall behavior, return values, or how actions differ. Incomplete for effective usage.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema provides 100% coverage with descriptions for all 5 parameters. The description adds no additional meaning beyond what is in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description '작업 예약 관리' (Task schedule management) is vague and does not specify the supported actions (add, list, remove) or intended use. The schema clarifies actions but the description itself lacks specificity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus siblings like glm_cmd or glm_shell_exec. No context on prerequisites or appropriate scenarios.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

glm_shell_execB

제한적 쉘 명령 실행 (화이트리스트 기반).

ParametersJSON Schema
NameRequiredDescriptionDefault
commandYes실행할 명령어 (화이트리스트 기반)
cwdNo작업 디렉토리 (기본값: 프로젝트 루트)
timeoutNo실행 제한 시간 (초, 기본 60초, 최대 300초)
capture_stderrNostderr도 함께 캡처

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must disclose behavioral traits. It only mentions 'whitelist-based' restrictions but fails to explain what happens on whitelist violation, side effects, or execution environment. The agent lacks critical behavioral context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence that conveys the core purpose without fluff. Every word earns its place, and the structure is efficient for quick understanding.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a potentially dangerous tool with multiple parameters and no output schema, the description is too sparse. It omits return values, error handling, whitelist details, and security implications, leaving the agent underinformed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3. The description reinforces the whitelist concept already present in the schema's command description, adding no extra meaning. The schema already documents defaults and limits for timeout and cwd.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states that the tool executes shell commands with restrictions ('제한적 쉘 명령 실행 (화이트리스트 기반)'). This distinguishes it from siblings like glm_code_run (code execution) and glm_http_request (HTTP requests), making the purpose specific and unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No usage guidance is provided beyond the description. It doesn't specify when to use this tool over alternatives like glm_cmd or glm_code_run, nor does it give any context about prerequisites or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

TDQS

C2.7/5.0
Disambiguation4/5

Most tools have distinct purposes, but 'glm_cmd' (delegating to GLM) and 'glm_bypass' (raw prompt) could confuse an agent. Also, multiple log-related tools (glm_action_log, glm_git_log) are separate but might be misinterpreted without careful reading.

Naming Consistency5/5

All tools follow a consistent 'glm_<domain>_<action>' pattern (e.g., glm_file_create, glm_git_commit). This makes the tool set predictable and easy to navigate.

Tool Count3/5

With 25 tools, the server is on the heavy side for a general-purpose assistant. While each tool serves a purpose, the count is borderline and could be streamlined by merging some functions (e.g., memory operations).

Completeness4/5

The tool surface covers a wide range: file operations, git, memory, code execution, web search, HTTP, image analysis, shell, scheduling, and DB queries. Minor gaps exist (e.g., no file rename or explicit memory update), but overall it's quite comprehensive for an AI assistant.

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    A local sandbox that provides AI agents with code execution, filesystem access, and a full GUI desktop environment for 'computer use' capabilities. It exposes tools for shell commands, multi-language code interpretation, and remote desktop automation via the Model Context Protocol.
    214
    GPL 3.0
  • A
    license
    A
    quality
    B
    maintenance
    Enables AI assistants to manage remote servers via SSH with 43 specialized tools for command execution, file editing, directory operations, and background tasks across Linux, macOS, and Windows.
    44
    5
    GPL 3.0
  • F
    license
    Not graded
    quality
    D
    maintenance
    Acts as the 'Hands and Eyes' for an Autonomous AI Agent, bridging Large Language Models and your local development environment to enable safe file manipulation, context reading, command execution, and documentation verification.
    2

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/coreline-ai/antigravity_glm_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server