AI导哈

模型上下文协议服务器

一个集成z.ai API的模型上下文协议服务器，专为Netlify上的轻松部署而设计，支持聊天完成、语义搜索和文本摘要等功能。

  • by britrik
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 britrik/zai-mcp-server

使用说明

z.ai用于Netlify的MCP服务器

模型上下文协议（MCP）服务器，与z.ai API集成，设计用于在Netlify上轻松部署。

特性

  • 聊天补全：与z.AI模型的对话式AI
  • 搜索：使用z.ai的语义搜索功能
  • 摘要：具有可自定义样式的文本摘要
  • Netlify就绪：使用SSE传输的无服务器部署
  • 生产就绪：错误处理、验证和环境配置

快速开始

1.部署到Netlify

  1. 将此存储库用作模板或将其分叉

  2. 将您的存储库连接到Netlify

  3. 在Netlify仪表板中设置环境变量：

    • ZAI_API_KEY：您的z.ai API密钥
    • ZAI_BASE_URL：（可选）自定义API基本URL
    • ZAI_MODEL：（可选）要使用的默认模型

  4. 部署！您的MCP服务器将在以下网址提供： https://your-site.netlify.app/mcp

2.地方发展

# Clone your repository
git clone https://github.com/your-username/zai-mcp-server
cd zai-mcp-server

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your z.ai API key

# Run the server
npm run dev

可用工具

zai_chat

向z.ai发送消息以获得对话式ai响应。

参数：

  • message （必填）：要发送的消息
  • system_prompt：上下文的可选系统提示
  • temperature：响应的随机性（0-1）
  • max_tokens：最大响应长度

zai_search

使用z.ai的搜索功能进行搜索。

参数：

  • query （必填）：搜索查询
  • limit：最大结果数（默认值：10）
  • filters：搜索筛选条件

扎伊尔概述

使用z.ai总结文本。

参数：

  • text （必填）：总结文本
  • length：摘要长度（短/中/长）
  • style：摘要风格（项目符号/段落/技术）

配置

环境变量

必修的：

  • ZAI_API_KEY：您的z.ai API密钥

可选：

  • ZAI_BASE_URL：API基本URL（默认值：https://api.z.ai)
  • ZAI_MODEL：默认型号（默认：claude-3-sonet-20240229）
  • ZAI_MAX_TOKENS：默认最大令牌数（默认值：4000）
  • ZAI_TEMPERATURE：默认温度（默认值：0.7）

与Poke集成

  1. 部署到Netlify后，您的MCP服务器URL将是： https://your-site.netlify.app/mcp
  2. 将此URL添加到您的Poke MCP连接中
  3. 通过Poke开始使用z.ai！

存储库结构

├── index.js                 # Main MCP server implementation
├── netlify/
│   └── functions/
│       └── mcp.js          # Netlify serverless function
├── netlify.toml            # Netlify configuration
├── package.json            # Dependencies and scripts
├── .env.example            # Environment variable template
└── README.md               # This file

发展

本地运行

服务器使用stdio传输运行本地MCP客户端连接：

npm start

MCP检验员测试

您可以使用MCP检查器工具在本地测试服务器：

npx @modelcontextprotocol/inspector node index.js

部署

Netlify部署

此存储库已配置为在Netlify上自动部署：

  1. 自动构建：Netlify将自动安装依赖项并部署
  2. 无服务器功能：MCP服务器作为Netlify功能运行
  3. 环境变量：在Netlify仪表板的“站点设置”下进行配置→ 环境变量
  4. 自定义域名：可选-在Netlify中设置自定义域

测试您的部署

部署后，测试您的MCP服务器：

curl https://your-site.netlify.app/mcp

用法示例

使用zai_chat

{
  "tool": "zai_chat",
  "arguments": {
    "message": "What is the capital of France?",
    "temperature": 0.7,
    "max_tokens": 1000
  }
}

使用zai_search

{
  "tool": "zai_search",
  "arguments": {
    "query": "latest developments in AI",
    "limit": 5
  }
}

使用zai_summarize

{
  "tool": "zai_summarize",
  "arguments": {
    "text": "Your long text here...",
    "length": "medium",
    "style": "paragraph"
  }
}

故障排除

常见问题

服务器无法在本地启动：

  • 检查一下 ZAI_API_KEY 设置在您的 .env 文件
  • 验证Node.js版本是否为18或更高： node --version
  • 确保安装了依赖项： npm install

Netlify部署失败：

  • 检查Netlify仪表板中的构建日志
  • 验证环境变量是否设置正确
  • 确保 package.json 和 netlify.toml 致力于

API错误：

  • 验证z.ai API密钥是否有效
  • 检查 ZAI_BASE_URL 是正确的
  • 审查API费率限制

许可证

MIT许可证-可根据需要自由使用和修改。

作者

理查德·休伊特

支持

对于此MCP服务器模板的问题，请在此存储库中创建问题。 有关z.ai API的问题，请参阅z.ai文档。

贡献

欢迎投稿！请随时提交拉取请求。

相关 MCP