Nexa MCP Server

MCP运维云端

提供方 hkjal1605

运维云端 未标注 无需鉴权 社区 / 第三方

一个基于TypeScript的Model Context Protocol (MCP)服务器开发模板,提供分层架构模式、示例工具和开发者基础设施,用于连接AI助手与外部API和数据源。

一句话选型结论

按资料字段整理

Nexa MCP Server 属于运维云端类 MCP 服务器,传输方式未标注,无需鉴权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

MCP服务器TypeScript本地部署TypeScript开发AI集成API连接开发模板

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Nexa MCP Server当前 未标注 未标注 未标注 无 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方hkjal1605上游标注的维护方 hkjal1605
分类运维云端本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.0 KB
来自项目仓库与上游目录的原文,未做删改

锅炉板MCP服务器

在TypeScript中开发自定义模型上下文协议(MCP)服务器的基础。提供完整的分层架构模式、工作示例工具和开发人员基础设施,将AI助手与外部API和数据源连接起来。

为什么要使用这个锅炉板?

  • 生产就绪架构:遵循已发布的MCP服务器中使用的相同模式,CLI、工具、控制器和服务之间保持了清晰的分离
  • 类型安全:使用TypeScript构建,以改善开发人员体验、代码质量和可维护性
  • 工作示例:包括完全实现的工具,演示从CLI到API集成的完整模式
  • 测试框架:用于单元和CLI集成测试的即用型测试基础架构,具有覆盖率报告功能
  • 完整的开发人员工具:预配置的ESLint、Prettier、TypeScript和CI/CD工作流

什么是MCP?

模型上下文协议(MCP)是一个开放标准,用于将人工智能系统安全地连接到外部工具和数据源。该样板文件采用一种干净、分层的体系结构来实现MCP规范,该体系结构可以扩展为为任何API或数据源构建自定义MCP服务器。

先决条件

  • Node.js (>=18.x): 下载
  • Git:用于版本控制

快速开始```bash

Clone the repository

git clone https://github.com/aashari/boilerplate-mcp-server.git
cd boilerplate-mcp-server

Install dependencies

npm install

Start development server

npm run dev:server

Try the example tool

npm run dev:cli -- get-ip-details 8.8.8.8


## 架构概述

Project Structure (Click to expand)```
src/
├── cli/              # Command-line interfaces
│   ├── index.ts      # CLI entry point
│   └── *.cli.ts      # Feature-specific CLI modules
├── controllers/      # Business logic
│   └── *.controller.ts  # Feature controllers
├── services/         # External API interactions
│   └── *.service.ts  # Service modules
├── tools/            # MCP tool definitions
│   ├── *.tool.ts     # Tool implementations
│   └── *.types.ts    # Tool argument schemas
├── types/            # Type definitions
│   └── common.types.ts # Shared type definitions
├── utils/            # Shared utilities
│   ├── logger.util.ts  # Structured logging
│   ├── error.util.ts   # Error handling
│   └── ...           # Other utility modules
└── index.ts          # Server entry point

分层架构

样板遵循一个干净、分层的架构,促进了可维护性和明确的关注点分离:

1.CLI层(src/cli/*.cli.ts)

  • 目的:解析参数和调用控制器的命令行接口
  • 模式:使用 commander 对于参数解析,调用控制器,使用以下命令处理错误 handleCliError
  • 命名: .cli.ts

2.工具层(src/tools/*.tool.ts)

  • 目的:向AI助手公开MCP工具定义
  • 模式:使用 zod 用于模式验证、呼叫控制器、MCP的格式响应
  • 命名: .tool.ts 类型在 .types.ts

3.控制器层(src/controllers/*.controller.ts)

  • 目的:业务逻辑编排、错误处理、响应格式
  • 模式:返回标准化 ControllerResponse 对象,根据上下文抛出错误
  • 命名: .controller.ts 可选 .formatter.ts

4.服务层(src/services/*.service.ts)

  • 目的:外部API交互和数据处理
  • 模式:具有最小逻辑的纯API调用,返回原始数据
  • 命名: .service.ts 或 vendor...service.ts

5. 工具层(src/utils/*.util.ts)

  • 目的:跨应用程序共享功能
  • 关键实用程序:日志记录、错误处理、格式化、配置

开发者指南

开发脚本```bash

Start server in dev mode with hot-reload & inspector

npm run dev:server

Run CLI commands in development

npm run dev:cli -- [command] [args]

Build the project

npm run build

Production server

npm start
npm run start:server

Production CLI

npm run start:cli -- [command] [args]

Testing

npm test # Run all tests
npm test -- src/path/to/test.ts # Run specific tests
npm run test:coverage # Generate coverage report

Code Quality

npm run lint # Run ESLint
npm run format # Format with Prettier
npm run typecheck # Check TypeScript types


### 调试工具

- **MCP检查员**:用于测试MCP工具的可视化工具

- 使用以下命令运行服务器 `npm run dev:server`
- 打开http://localhost:5173在您的浏览器中

- **服务器日志**:启用 `DEBUG=true npm run dev:server` 或在配置中

Configuration (Click to expand)

创建 `~/.mcp/configs.json`:```json
{
"boilerplate": {
"environments": {
"DEBUG": "true",
"ANY_OTHER_CONFIG": "value"
}
}
}

构建自定义工具

Step-by-Step Tool Implementation Guide (Click to expand)

1.定义服务层

在中创建新服务 src/services/ 与外部API交互:```typescript
// src/services/example.service.ts
import { Logger } from '../utils/logger.util.js';

const logger = Logger.forContext('services/example.service.ts');

export async function getData(param: string): Promise {
logger.debug('Getting data', { param });
// API interaction code here
return { result: 'example data' };
}


### 2.创建控制器

在中添加控制器 `src/controllers/` 处理业务逻辑:```typescript
// src/controllers/example.controller.ts
import { Logger } from '../utils/logger.util.js';
import * as exampleService from '../services/example.service.js';
import { formatMarkdown } from '../utils/formatter.util.js';
import { handleControllerError } from '../utils/error-handler.util.js';
import { ControllerResponse } from '../types/common.types.js';

const logger = Logger.forContext('controllers/example.controller.ts');

export interface GetDataOptions {
param?: string;
}

export async function getData(
options: GetDataOptions = {},
): Promise {
try {
logger.debug('Getting data with options', options);

const data = await exampleService.getData(options.param || 'default');

const content = formatMarkdown(data);

return { content };
} catch (error) {
throw handleControllerError(error, {
entityType: 'ExampleData',
operation: 'getData',
source: 'controllers/example.controller.ts',
});
}
}

3.实施MCP工具

在中创建工具定义 src/tools/:```typescript
// src/tools/example.tool.ts
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { z } from 'zod';
import { Logger } from '../utils/logger.util.js';
import { formatErrorForMcpTool } from '../utils/error.util.js';
import * as exampleController from '../controllers/example.controller.js';

const logger = Logger.forContext('tools/example.tool.ts');

const GetDataArgs = z.object({
param: z.string().optional().describe('Optional parameter'),
});

type GetDataArgsType = z.infer;

async function handleGetData(args: GetDataArgsType) {
try {
logger.debug('Tool get_data called', args);

const result = await exampleController.getData({
param: args.param,
});

return {
content: [{ type: 'text' as const, text: result.content }],
};
} catch (error) {
logger.error('Tool get_data failed', error);
return formatErrorForMcpTool(error);
}
}

export function register(server: McpServer) {
server.tool(
'get_data',
Gets data from the example API, optionally using \param`.
Use this to fetch example data. Returns formatted data as Markdown.`,
GetDataArgs.shape,
handleGetData,
);
}


### 4.添加CLI支持

在中创建CLI命令 `src/cli/`:```typescript
// src/cli/example.cli.ts
import { program } from 'commander';
import { Logger } from '../utils/logger.util.js';
import * as exampleController from '../controllers/example.controller.js';
import { handleCliError } from '../utils/error-handler.util.js';

const logger = Logger.forContext('cli/example.cli.ts');

program
.command('get-data')
.description('Get example data')
.option('--param ', 'Optional parameter')
.action(async (options) => {
try {
logger.debug('CLI get-data called', options);

const result = await exampleController.getData({
param: options.param,
});

console.log(result.content);
} catch (error) {
handleCliError(error);
}
});

5.注册组件

更新入口点以注册新组件:```typescript
// In src/cli/index.ts
import '../cli/example.cli.js';

// In src/index.ts (for the tool)
import exampleTool from './tools/example.tool.js';
// Then in registerTools function:
exampleTool.register(server);


## 发布您的MCP服务器

1. 用您的详细信息更新package.json:```json
{
"name": "your-mcp-server-name",
"version": "1.0.0",
"description": "Your custom MCP server",
"author": "Your Name",
// Other fields...
}
  1. 使用您的工具文档更新README.md

  2. 构建: npm run build

  3. 测试: npm run start:server

  4. 发布: npm publish

测试最佳实践

  • 单元测试:单独测试实用程序和纯函数
  • 控制器测试:使用模拟服务调用测试业务逻辑
  • 集成测试:使用真实依赖关系测试CLI
  • 覆盖目标:目标测试覆盖率>80%

许可证

ISC许可证

资源

  • MCP规范
  • MCP官方文件
  • TypeScript文档

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
Nexa MCP Server 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Nexa MCP Server 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Nexa MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Nexa MCP Server 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Nexa MCP Server 能提供哪些能力?

资料显示能力标签包括 开发模板、API集成、TypeScript、TypeScript开发、本地部署。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。