MCP服务器模板

预备条件

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
   

架构工具

架构工具（src/tools/architect.ts）提供了一个与LLM CLI交互以获取架构设计反馈的接口。它维护对话上下文，并处理应用程序与LLM CLI之间的通信。

功能

• 在多次交互中维护对话上下文
• 通过LLM CLI执行命令
• 提供错误处理和日志记录
• 支持新对话和继续讨论

要求

• 必须安装并可在PATH中访问LLM CLI（参见预备条件部分）
• 应正确配置环境变量以供LLM CLI使用

测试

模板包括内置的TestClient用于本地测试以及MCP Inspector用于可视化调试。

使用TestClient

TestClient提供了一种简单的方式来测试你的工具：

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

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

  it("应正确处理数据", async () => {
    await client.assertToolCall(
      "your-tool-name",
      { input: "test" },
      (result) => {
        expect(result.toolResult.content).toBeDefined();
      }
    );
  });
});

使用MCP Inspector

模板包括MCP Inspector用于你的工具的可视化调试：

1. 启动Inspector：

   npx @modelcontextprotocol/inspector node dist/index.js
   

2. 在http://localhost:5173打开Inspector UI

Inspector提供了：

• 测试工具的可视化界面
• 实时请求/响应监控
• 工具元数据检查
• 交互式测试环境

使用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. 通过检查MCP服务器部分显示你的服务器正在运行来验证服务器在Cursor中的启动情况。

注意：如果你对代码进行了更改，请记得重新构建和重新链接：

npm run build
npm run link

完成测试后，可以取消链接包：

npm run unlink

这将移除开发期间创建的全局符号链接。

故障排除

使用MCP Inspector

MCP Inspector是一个有用的调试和检查MCP服务器的工具。使用方法如下：

1. 首先，构建你的项目：

   npm run build
   

2. 运行Inspector：

   npx @modelcontextprotocol/inspector node dist/index.js
   

Inspector提供了一个Web界面，允许你：

• 查看所有可用工具及其模式
• 交互式测试工具调用
• 检查请求/响应负载
• 调试服务器与客户端之间的通信问题