GLM MCP服务器

GLM MCP Ultimate服务器允许Claude Code和其他MCP兼容客户端使用GLM(智谱AI)模型,提供自主编码代理、聊天功能、图像分析和文本嵌入。

  • by GlitterKill
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 GlitterKill/glm-mcp-ultimate

使用说明

GLM MCP终极服务器

GLM MCP Ultimate服务器允许Claude Code和其他MCP兼容客户端使用GLM(智普AI)模型。它提供了一个自主编码代理、聊天功能、图像分析和文本嵌入。

特征

  • 专注任务执行:将GLM作为子代理运行,以便在将结果返回给编排器之前,在新的、隔离的上下文中自主完成特定任务。
  • GLM聊天:向GLM模型发送直接提示,以获取快速问题或第二意见。
  • GLM愿景:通过提供URL或base64数据,使用GLM-4V分析图像。
  • GLM嵌入:为搜索和检索任务生成高质量的文本嵌入。
  • SQLite持久化:用于会话、消息和代理步骤的强大存储。

先决条件

安装

选项1:易于安装(NPM)

全局安装软件包:

npm install -g @glitterkill/glm-mcp-ultimate

选项2:手动安装(开发)

  1. 克隆存储库:
    git clone https://github.com/your-repo/glm-mcp-ultimate.git
    cd glm-mcp-ultimate
    
  2. 安装依赖项并构建:
    npm install
    npm run build
    

配置

与Claude Desktop一起使用

要将此服务器与Claude Desktop一起使用,请将其添加到配置文件中:

  • 视窗: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

将以下条目添加到 mcpServers 对象:

如果通过NPM安装:

{
  "mcpServers": {
    "glm": {
      "command": "npx",
      "args": ["-y", "@glitterkill/glm-mcp-ultimate"],
      "env": {
        "GLM_API_KEY": "your_api_key_here"
      }
    }
  }
}

如果手动安装:

{
  "mcpServers": {
    "glm": {
      "command": "node",
      "args": ["/path/to/glm-mcp-ultimate/dist/index.js"],
      "env": {
        "GLM_API_KEY": "your_api_key_here"
      }
    }
  }
}

可用工具

自主代理

  • glm_run_task:使用新的GLM会话执行一个集中的任务。该工具通过为每个任务生成一个新的会话,在指定的步骤限制内自主操作,并将结果直接返回给编排LLM,从而最大限度地减少了上下文污染。

通用工具

  • glm_chat:向GLM模型发送提示并接收文本响应。
  • glm_vision:使用GLM-4V提供图像和视觉分析提示。
  • glm_embeddings:使用GLM嵌入模型将文本转换为向量嵌入。

代理能力

在自主模式下运行时,GLM代理可以执行以下操作:

  • 文件操作:使用精确的文本替换来读取、创建和编辑文件。
  • 系统命令:执行shell命令以运行测试、安装包或执行版本控制。
  • 代码探索:列出文件并搜索整个代码库中的模式。
  • 任务完成:一旦达到目标,请提供详细的总结。

环境变量

  • GLM_API_KEY:必填。您的Zhipu AI API密钥(支持Z.AI编码计划密钥)。
  • GLM_MODEL:可选。要使用的默认GLM模型(默认为 glm-5).
  • GLM_API_BASE:可选。覆盖GLM API的基本URL(默认为 https://api.z.ai/api/coding/paas/v4).

CLI命令用法

除了充当MCP服务器外,GLM MCP Ultimate还为终端用户提供直接的CLI命令。这允许您与模型交互,而不需要像Claude Code这样的MCP客户端。

全球安装: 如果您全局安装了该软件包,则可以使用 glm-mcp-ultimate 直接命令:

# General Chat
glm-mcp-ultimate chat "Write a python script to reverse a string"

# Start Autonomous Agent
glm-mcp-ultimate agent "Refactor the authentication module" -d ./src/auth

# Image Analysis
glm-mcp-ultimate vision "Describe this image" https://example.com/image.jpg

# Generate Embeddings
glm-mcp-ultimate embeddings "Hello world"

使用NPX: 如果您不想全局安装,可以使用 npx:

npx -y @glitterkill/glm-mcp-ultimate chat "What is the capital of France?"

注意:确保 GLM_API_KEY 在运行这些命令之前设置环境变量。