Glm MCP Server

🚀 GLM-4.6 MCP Server

このサーバーは、Claude 4.5 SonnetとGLM-4.6の間に双方向のプロトコルブリッジを構築し、開発ワークフロー中にリアルタイムのアーキテクチャコンサルティングを可能にします。標準化されたMCPツールを通じてGLM-4.6の専門機能を公開し、Warp Terminalのエージェントインフラストラクチャとのシームレスな統合を促進します。

🚀 クイックスタート

前提条件

node >= 18.0.0
npm >= 9.0.0
https://open.bigmodel.cn から取得したGLM-4.6 APIキー

インストール

cd glm-mcp-server
npm install
npm run build

環境構成

プロジェクトのルートに .env ファイルを作成します。

GLM_API_KEY=your_api_key_here

⚠️ 重要提示

.env ファイルをバージョン管理システムにコミットしないでください。本番環境では安全なシークレット管理を使用してください。

✨ 主な機能

アーキテクチャ機能

• 分散システム設計：マイクロサービスパターン、サービスメッシュアーキテクチャ、イベント駆動型システム
• スケーラビリティエンジニアリング：水平スケーリング戦略、ロードバランシング、キャッシュ階層
• セキュリティアーキテクチャ：脅威モデリング、ゼロトラストパターン、認証/承認フレームワーク
• コード分析：SOLID原則評価、設計パターン認識、リファクタリング推奨事項
• 技術的決定レビュー：トレードオフ分析、リスク評価、代替アプローチ評価
• システムアーキテクチャ設計：コンポーネント分解、データフローモデリング、テクノロジースタック選択

🔧 Warp Terminalとの統合

MCPサーバー構成

WarpのMCPサーバー構成ファイルに以下の構成を追加します。 場所：~/.config/warp-terminal/mcp_servers.json または Warp Settings → MCP Servers

{
  "mcpServers": {
    "glm-architecture": {
      "command": "node",
      "args": ["/absolute/path/to/glm-mcp-server/build/index.js"],
      "env": {
        "GLM_API_KEY": "your_glm_api_key_here"
      }
    }
  }
}

⚠️ 重要提示

• /absolute/path/to/glm-mcp-server を実際のインストールパスに置き換えてください。
• your_glm_api_key_here を実際のGLM APIキーに置き換えてください。
• 構成を変更した後、Warp Terminalを再起動してください。

検証

# サーバー機能をテストする
node build/index.js
# 期待される出力: "GLM-4.6 MCP Server running on stdio"

📡 MCPツールリファレンス

1. consult_architecture

システム設計パターン、スケーラビリティ戦略、および技術的ガイダンスに関する一般的なアーキテクチャコンサルティングです。

入力スキーマ：

{
  query: string;        // 専門家のコンサルティングが必要なアーキテクチャに関する質問
  context?: string;     // オプションのシステムコンテキスト、要件、制約条件
}

ユースケース：高レベルのアーキテクチャ決定、パターン選択、スケーラビリティ計画

2. analyze_code_architecture

ソースコードのアーキテクチャ分析で、設計パターン、SOLID原則、および改善提案を含みます。

入力スキーマ：

{
  code: string;         // 分析するソースコード
  language: string;     // プログラミング言語 (typescript、python、go、javaなど)
  question: string;     // コードに関する具体的なアーキテクチャの質問
}

ユースケース：コードレビュー、リファクタリング計画、設計パターン評価

3. design_system_architecture

要件から完全なシステムアーキテクチャ設計を行い、コンポーネントの分解、データフロー、およびデプロイメント戦略を含みます。

入力スキーマ：

{
  requirements: string; // 詳細なシステム要件、制約条件、目標
}

ユースケース：新しいシステム設計、アーキテクチャドキュメント、テクノロジー選択

4. review_technical_decision

技術的決定のレビューで、影響評価、トレードオフ分析、および代替案の推奨事項を含みます。

入力スキーマ：

{
  decision: string;     // レビューする技術的決定
  context: string;      // 現在のアーキテクチャ、制約条件、目標
}

ユースケース：アーキテクチャレビュー、テクノロジー評価、リスク評価

💻 使用例

例1: アーキテクチャコンサルティング

Warp Terminal内で、Claudeは以下のように呼び出すことができます。

// ClaudeがMCPを介して自動的に呼び出す
consult_architecture({
  query: "What's the optimal caching strategy for a high-traffic API with 10k req/s?",
  context: "Node.js microservices, PostgreSQL database, AWS infrastructure"
})

例2: コードアーキテクチャ分析

analyze_code_architecture({
  code: `class UserService { ... }`,
  language: "typescript",
  question: "Does this service follow clean architecture principles?"
})

例3: システム設計

design_system_architecture({
  requirements: `
    - Real-time messaging platform
    - 1M concurrent users
    - Sub-100ms latency
    - 99.99% uptime SLA
    - Global distribution
  `
})

🏛️ アーキテクチャ

┌─────────────────────────────────────────────────────────────┐
│                      Warp Terminal                          │
│  ┌──────────────────────────────────────────────────────┐   │
│  │              Claude 4.5 Sonnet Agent                 │   │
│  └────────────────────┬─────────────────────────────────┘   │
└───────────────────────┼─────────────────────────────────────┘
                        │ MCP Protocol (stdio)
                        ▼
┌─────────────────────────────────────────────────────────────┐
│                  GLM MCP Server (Node.js)                   │
│  ┌──────────────────────────────────────────────────────┐   │
│  │  MCP Protocol Handler  │  Tool Registry              │   │
│  ├──────────────────────────────────────────────────────┤   │
│  │            GLM-4.6 API Client Layer                  │   │
│  │  • Authentication  • Error Handling  • Retry Logic   │   │
│  └──────────────────────────────────────────────────────┘   │
└────────────────────────┬────────────────────────────────────┘
                         │ HTTPS/REST
                         ▼
┌─────────────────────────────────────────────────────────────┐
│          GLM-4.6 API (open.bigmodel.cn)                     │
│              Zhipu AI Model Inference                       │
└─────────────────────────────────────────────────────────────┘

🛠️ 開発

ビルド

npm run build      # TypeScriptをJavaScriptにコンパイルする
npm run watch      # 自動再ビルドの開発モード

プロジェクト構造

glm-mcp-server/
├── src/
│   ├── index.ts           # MCPサーバーのエントリポイント
│   └── glm-client.ts      # GLM-4.6 APIクライアント
├── build/                 # コンパイルされたJavaScriptの出力
├── package.json           # 依存関係とスクリプト
├── tsconfig.json          # TypeScriptの構成
└── .env                   # 環境変数 (バージョン管理に含まれない)

🔐 セキュリティに関する考慮事項

• APIキー管理：GLM_API_KEYを環境変数に保存し、コードには決して記述しないでください。
• トランスポートセキュリティ：すべてのAPI通信にHTTPS/TLSを使用します。
• 入力検証：すべてのツール入力は処理前に検証されます。
• エラーハンドリング：エラーメッセージから機密情報を削除します。
• レート制限：本番デプロイではクライアント側のレート制限を実装します。

📊 パフォーマンス特性

🐛 トラブルシューティング

サーバーが起動しない場合

# Node.jsのバージョンを確認する
node --version  # 18.0.0以上である必要があります

# ビルド出力を確認する
npm run build

# GLM_API_KEYが設定されていることを確認する
echo $GLM_API_KEY

API認証エラーの場合

• https://open.bigmodel.cn でAPIキーの有効性を確認してください。
• APIキーに十分なクォータがあることを確認してください。
• .env ファイルに空白がないことを確認してください。

Warp Terminalの統合に問題がある場合

• 構成を変更した後、Warp Terminalを再起動してください。
• MCP構成の絶対パスを確認してください。
• Warpのログを確認してください: Warp → Settings → Advanced → View Logs

📚 リソース

• GLM-4.6ドキュメント：https://docs.z.ai/guides/llm/glm-4.6
• モデルコンテキストプロトコル：https://modelcontextprotocol.io
• Warp MCP統合：https://docs.warp.dev/features/agent-mode/model-context-protocol

📄 ライセンス

MITライセンス - Copyright (c) 2025 CyberLink Security

🤝 サポート

エンタープライズサポート：info@cyberlinksec.com

問題報告：サーバーログ、Warpのバージョン、再現手順を含めてください。