使用说明
MCP服务器模板
先决条件
LLM CLI安装
此项目需要安装LLM CLI。您可以使用Homebrew安装它：
brew install llm
安装后，确保 llm 通过运行以下命令，可以在PATH中使用该命令：
llm --version
入门指南
发展
-
安装依赖项：
npm install -
使用热重载启动开发服务器：
npm run dev -
构建项目：
npm run build -
运行测试：
npm test -
启动生产服务器：
npm start
架构师工具
架构师工具(src/tools/architect.ts)提供了一个与LLM CLI交互的界面，用于架构设计反馈。它维护对话上下文，并处理应用程序和LLM CLI之间的通信。
特性
- 在多个交互中维护对话上下文
- 通过LLM CLI处理命令执行
- 提供错误处理和日志记录
- 支持新对话和继续讨论
需求
- LLM CLI必须在PATH中安装并可用（请参阅先决条件部分）
- 应为LLM CLI正确配置环境变量
测试
该模板包括用于本地测试的内置TestClient和用于可视化调试的MCP检查器。
使用测试客户端
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检查器：
-
启动检查器：
npx @modelcontextprotocol/inspector node dist/index.js -
打开检查器UI http://localhost:5173
检查员提供：
- 测试工具的可视化界面
- 实时请求/响应监控
- 工具元数据检查
- 交互式测试环境
使用游标进行本地测试
要使用Cursor在本地测试MCP服务器，请执行以下操作：
-
构建并链接包：
npm run build npm run link -
验证二进制文件是否正常工作：
npx architect-test-mcp-tool -
将服务器添加到游标：
- 打开光标设置
- 导航到“功能”选项卡
- 向下滚动到MCP服务器部分
- 点击“添加服务器”
- 选择“命令”类型
- 为其命名（例如，“本地示例工具”）
- 输入命令：
npx architect-test-mcp-tool - 单击确认
-
通过检查MCP服务器部分是否显示您的服务器正在运行，验证服务器是否在Cursor中正确启动。
注意：如果您对代码进行了更改，请记住重建并重新链接：
npm run build
npm run link
测试完成后，您可以取消包的链接：
npm run unlink
这将删除开发过程中创建的全局符号链接。
故障排除
使用MCP检查器
MCP检查器是调试和检查MCP服务器的有用工具。要使用它：
-
首先，构建您的项目：
npm run build -
运行检查器：
npx @modelcontextprotocol/inspector node dist/index.js
检查器提供了一个web界面，允许您：
- 查看所有可用工具及其模式
- 交互式测试工具调用
- 检查请求/响应有效载荷
- 调试服务器和客户端之间的通信问题
