返回 MCP 目录
public公开dns本地运行

mcp-server-meraki

MCP Server Meraki是一个标准化接口项目,用于通过MCP协议与Meraki基础设施进行交互,提供数据验证、错误处理和模块化架构。

article

README

🚀 MCP 服务器 Meraki

本项目是用于 Meraki 的 Model-Context-Protocol (MCP) 服务器,提供了与 Meraki 基础设施交互的标准接口,采用 MCP 协议,可高效实现与 Meraki API 的交互。

🚀 快速开始

先决条件

  • Node.js 18 或更高版本
  • npm
  • Meraki API 密钥

安装

  1. 克隆仓库:
git clone https://github.com/Censini/mcp-server-meraki.git
cd mcp-server-meraki
  1. 安装依赖项:
npm install

配置

在项目根目录创建一个 .env 文件,添加以下变量:

MERAKI_API_KEY=votre_clé_api

启动

以开发模式启动服务器:

npm start

测试

运行测试:

npm test

✨ 主要特性

  • 提供统一的接口用于管理 Meraki 资源。
  • 使用 Zod 进行严格的数据验证,确保数据准确性。
  • 具备强健的错误处理机制,保障系统稳定性。
  • 采用模块化且可扩展的架构,方便功能拓展。

📦 安装指南

  1. 克隆仓库:
git clone https://github.com/Censini/mcp-server-meraki.git
cd mcp-server-meraki
  1. 安装依赖项:
npm install

🔧 技术细节

使用的技术

  • TypeScript:提供类型检查,增强代码的可维护性。
  • Model Context Protocol SDK (@modelcontextprotocol/sdk):用于实现 MCP 协议相关功能。
  • Zod 用于数据验证:确保输入数据的合法性。
  • Jest 用于测试:保证代码的质量和稳定性。

项目结构

src/
├── __tests__/     # 单元测试文件夹
├── services/      # 业务逻辑服务
├── types/         # TypeScript 类型定义
├── errors.ts      # 错误处理
└── server.ts      # 服务器入口点

🤝 贡献

欢迎贡献!请按照以下步骤进行:

  1. 分叉仓库
  2. 为新功能创建分支 (git checkout -b feature/ma-fonctionnalite)
  3. 提交更改 (git commit -m 'Ajout de ma fonctionnalité')
  4. 推送到远程分支 (git push origin feature/ma-fonctionnalite)
  5. 提交 Pull Request

📄 许可证

本项目使用 MIT 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端