Stevennevins Architect MCP Server

🚀 MCP 服務器模板

MCP 服務器模板提供了便捷的開發與測試環境，藉助大語言模型（LLM）命令行界面（CLI），可獲取架構設計反饋，還具備多種測試工具輔助開發。

🚀 快速開始

先決條件

LLM CLI 安裝

此項目需要安裝大語言模型（LLM）命令行界面（CLI）。您可以使用 Homebrew 進行安裝：

brew install llm

安裝完成後，確保 llm 命令在您的 PATH 中可用，運行以下命令進行驗證：

llm --version

入門指南

開發

1. 安裝依賴項：

npm install

2. 使用熱重載啟動開發服務器：

npm run dev

3. 構建項目：

npm run build

4. 運行測試：

npm test

5. 啟動生產服務器：

npm start

✨ 主要特性

架構工具特性

• 維護跨多次交互的對話上下文
• 處理通過 LLM CLI 執行命令
• 提供錯誤處理和日誌記錄
• 支持新對話和繼續討論兩種模式

檢查器功能

• 維護對話上下文：確保工具在多次交互中保持一致的上下文。
• 處理 LLM 命令：通過 CLI 執行大語言模型相關操作。
• 錯誤處理和日誌記錄：提供詳細的錯誤信息和日誌以幫助調試。

📦 安裝指南

依賴管理

使用 Node 包管理器（npm）進行依賴項安裝和版本管理，確保項目順利運行。

💻 使用示例

架構工具使用

src/tools/architect.ts 中的架構工具提供了與 LLM CLI 交互的接口，用於獲取架構設計反饋。它維護對話上下文並處理應用程序與 LLM CLI 之間的通信。

測試工具使用

使用 TestClient

TestClient 提供了一個簡單的方法來測試工具：

import { TestClient } from "./utils/TestClient";

describe("YourTool", () => {
  const client = new TestClient();

  it("should process data correctly", async () => {
    await client.assertToolCall(
      "your-tool-name",
      { input: "test" },
      (result) => {
        expect(result.toolResult.content).toBeDefined();
      }
    );
  });
});

使用 MCP 檢查器

該模板包含 MCP 檢查器用於可視化調試工具：

1. 啟動檢查器：

npx @modelcontextprotocol/inspector node dist/index.js

2. 在瀏覽器中打開檢查器界面：http://localhost:5173

使用 Cursor 進行本地測試

要在 Cursor 中使用您的 MCP 服務器進行本地測試：

1. 構建並鏈接包：

npm run build
npm run link

2. 驗證二進制文件是否正常工作：

npx architect-test-mcp-tool

3. 將服務器添加到 Cursor 中：
   • 打開 Cursor 設置
   • 點擊“功能”選項卡
   • 滾動到底部，找到“MCP 服務器”部分
   • 點擊“添加服務器”
   • 選擇“命令”類型
   • 輸入名稱（例如：“本地示例工具”）
   • 輸入命令：npx architect-test-mcp-tool
   • 點擊“確認”
4. 在 Cursor 中檢查 MCP 服務器部分，確保您的服務器顯示為運行狀態。

⚠️ 重要提示

如果對代碼進行了更改，請記得重新構建並重新鏈接：

npm run build
npm run link

完成測試後，可以使用以下命令解鏈：

npm run unlink

此命令會刪除開發期間創建的全局符號鏈接。

📚 詳細文檔

架構工具要求

• 必須安裝並配置好 LLM CLI（參見先決條件部分）
• 環境變量應正確配置以支持 LLM CLI