使用说明

MCP服务器集合

此存储库包含我为各种用例和集成开发的模型上下文协议（MCP）服务器的集合。

什么是MCP？

模型上下文协议（MCP）是一种使AI助手能够连接到外部数据源和工具的协议。MCP服务器提供对各种API、数据库和服务的结构化访问，允许AI模型以标准化的方式检索和操作数据。

项目结构

mcp-servers/
├── latitude-sh/      # Latitude.sh infrastructure MCP server
│   ├── src/          # TypeScript source code
│   ├── dist/         # Compiled JavaScript
│   ├── README.md     # Server documentation
│   └── USAGE.md      # Usage guide with examples
├── weather/          # Weather data MCP server
│   ├── src/          # TypeScript source code
│   ├── build/        # Compiled JavaScript
│   ├── package.json
│   └── README.md
└── README.md         # This file

可用服务器

Latitude.sh基础架构服务器

位置: latitude-sh/
描述：用于Latitude.sh基础设施管理的全面MCP服务器
特性:
- 29个MCP工具，用于完整的基础设施控制
- 项目管理（CRUD操作）
- 服务器生命周期管理
- 智能服务器创建与验证
- 计划和区域可用性检查
- 用于指导工作流程的交互式脚本
版本：v0.5.0
API集成：Latitude.sh REST API

天气服务器

位置: weather/
描述：用于检索天气信息和预报的MCP服务器
特性：实时天气数据、预报和基于位置的天气服务
版本：v1.0.0
API集成：美国国家气象局（NWS）API

全球先决条件

在使用此集合中的任何MCP服务器之前，请确保您已：

系统要求

Node.js：18.0.0或更高版本（推荐：LTS版本）
npm：8.0.0或更高版本（附带Node.js）
TypeScript：5.0.0或更高版本（用于开发）
操作系统：Windows 10+、macOS 10.15+或Linux（Ubuntu 20.04+）

开发工具

Git：用于版本控制
代码编辑器：VS代码建议使用TypeScript扩展
终端：用于运行脚本的命令行界面

MCP客户端

要使用这些服务器，您需要一个兼容MCP的客户端，例如：

克劳德桌面：Anthropic官方客户
自定义MCP客户端：使用MCP SDK构建
CLI工具：命令行MCP客户端

发展

此集合中的每个MCP服务器都是作为一个独立的Node.js/TypeScript项目开发的，具有自己的依赖关系和配置。

建筑

所有服务器都遵循一致的架构：

server-name/
├── src/                 # TypeScript source code
│   ├── index.ts        # Main server entry point
│   ├── types/          # Type definitions
│   └── utils/          # Utility functions
├── dist/               # Compiled JavaScript
├── package.json        # Dependencies and scripts
├── tsconfig.json       # TypeScript configuration
├── README.md           # Server-specific documentation
└── USAGE.md           # Usage examples (where applicable)

添加新服务器

为您的服务器创建一个新目录
初始化一个新的Node.js项目
安装MCP依赖项
实现服务器逻辑
在服务器的README.md中添加文档

贡献

这是MCP服务器的个人集合。您可以根据自己的项目自由地分叉和调整这些服务器。

贡献指南

如果你想做出改进：

分叉存储库
创建要素分支: git checkout -b feature/amazing-improvement
遵循现有代码样式 以及架构模式
添加测试 在适用的情况下使用新功能
更新文档 包括README.md和USAGE.md文件
提交拉取请求 清晰地描述了变化

代码规范

TypeScript：使用严格的类型检查
埃斯林特：遵循现有的棉绒规则
文档：记录所有公共API和复杂逻辑
测试：添加新功能的测试（如适用）

常见问题解答

一般问题

Q：什么是模型上下文协议（MCP）？ A： MCP是一种协议，使AI助手能够以标准化的方式连接到外部数据源和工具。它允许AI模型从各种API和服务中检索和操纵数据。

Q：哪些MCP客户端与这些服务器兼容？ A：这些服务器可与任何兼容MCP的客户端配合使用，包括Claude Desktop、使用MCP SDK构建的自定义客户端和命令行工具。

Q：我可以在生产环境中使用这些服务器吗？ A：是的，但请确保遵循安全最佳实践，使用正确的API密钥管理，并实施适当的错误处理和监控。

技术问题

Q：为什么我需要Node.js 18或更高版本？ A：这些服务器使用现代JavaScript功能和最新的MCP SDK，需要Node.js 18+才能获得最佳性能和安全性。

Q：如何解决连接问题？ A：检查API密钥、网络连接，并参阅README.md或USAGE.md文件中特定服务器的故障排除部分。

Q：我可以修改这些服务器以供自己使用吗？ A：当然！这些服务器在MIT许可下是开源的。根据需要进行分叉、修改和调整。

服务器特定问题

Q： Latitude.sh服务器是否支持所有API功能？ A：服务器实现了24个工具，涵盖了最常用的Latitude.sh API端点。检查中的工具列表 latitude-sh/README.md 全面覆盖。

Q：天气服务器仅限于美国吗？ A：是的，天气服务器使用美国国家气象局API，只提供美国领土的数据。

MCP服务器集合

使用说明