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
检查员提供：
- 测试工具的可视化界面
- 实时请求/响应监控
- 工具元数据检查
- 交互式测试环境
使用游标进行本地测试
要使用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界面，允许您：
- 查看所有可用工具及其模式
- 交互式测试工具调用
- 检查请求/响应有效载荷
- 调试服务器和客户端之间的通信问题