MCP 服务器

MCP Template Node

一个用于在 Node.js/TypeScript 中创建模型上下文协议 (MCP) 服务器的模板仓库。此模板演示了如何使用 MCP 协议构建一个简单的笔记管理系统，该系统可以与 LLM 驱动的应用程序一起使用。

Rethunk-Tech

开发者工具

访问服务器

README

MCP 模板节点

一个用于在 Node.js/TypeScript 中创建模型上下文协议 (MCP) 服务器的模板仓库。此模板演示了一个使用 MCP 协议的简单笔记管理系统。

什么是 MCP？

模型上下文协议 (MCP) 是一种应用程序向大型语言模型 (LLM) 提供上下文信息的标准化方法。请访问模型上下文协议网站了解更多信息。

特性

使用严格类型检查的 TypeScript 实现
具有基本 CRUD 操作的简单笔记管理系统
完整的 MCP 概念示例（工具、资源、提示）
用于存储笔记的内存存储
完善的错误处理和验证
使用 Vitest 进行单元测试
VS Code 调试配置
用于测试和构建的 GitHub Actions CI 工作流程

前提条件

Node.js 18 或更高版本
npm 或 yarn

项目结构

mcp-template-node/
├── build/                # 编译后的 JavaScript 文件
├── src/
│   ├── __tests__/        # 集成测试和测试实用程序
│   ├── errors/           # 自定义错误类
│   ├── tools/            # MCP 工具实现
│   │   └── __tests__/    # 工具单元测试
│   ├── types/            # TypeScript 类型定义
│   │   └── __tests__/    # 类型测试
│   └── index.ts          # 带有 MCP 示例的主服务器入口点
├── package.json          # 项目配置
├── tsconfig.json         # TypeScript 配置
├── eslint.config.mjs     # ESLint flat 配置
└── README.md             # 项目文档

快速开始

克隆仓库：

git clone https://github.com/Rethunk-Tech/mcp-template-node.git
cd mcp-template-node

安装依赖：
```
yarn install
```
构建并运行服务器：
```
yarn build
yarn start
```

开发

在 watch 模式下启动 TypeScript 编译器：yarn dev
检查你的代码：yarn lint
修复 lint 问题：yarn lint:fix
运行测试：yarn test

测试

该项目包含全面的测试，以验证 MCP 服务器及其工具的功能。

运行测试

运行所有测试：

yarn test

在 watch 模式下运行测试（当文件更改时重新运行测试）：

yarn test:watch

运行带有覆盖率的测试：

yarn test:coverage

测试结构

单元测试: 位于它们测试的代码附近的 __tests__ 目录中
集成测试: 位于 src/__tests__/ 中
测试实用程序: src/__tests__/test-utils.ts 中的通用测试助手

编写测试

该项目包含一个 MockMcpServer，用于在没有真实 MCP 依赖项的情况下测试工具：

import { MockMcpServer } from '../__tests__/test-utils.js';

describe('My Tool Tests', () => {
  let server: MockMcpServer;

  beforeEach(() => {
    server = new MockMcpServer();
    // 注册工具
    registerMyTools(server as any);
  });

  it('should perform some action', async () => {
    const result = await server.callTool('my_tool', { param: 'value' });
    expect(result.content[0].text).toContain('Expected text');
  });
});