AI导哈

MCP服务器管理门户

一个用于浏览和管理模型上下文协议(MCP)服务器的现代Web门户，提供服务器实现和工具支持。

  • by mykie2015
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 mykie2015/my_mcp_servers

使用说明

我的MCP服务器

模型上下文协议（MCP）服务器的综合集合，具有用于浏览和管理它们的现代门户网站。此存储库提供服务器实现和工具，使使用MCP服务器更容易。

🚀 特性

门户网站

  • 现代用户界面：与cursor.directory类似的漂亮深色主题界面
  • 服务器浏览器：显示服务器信息的视觉卡片，带有搜索和过滤功能
  • 配置管理：一键复制Claude Desktop配置
  • 安装指南：每台服务器的分步说明
  • 实时文档：集成README查看和服务器状态

MCP服务器

  • 时间MCP服务器：全面的时间和时区转换功能
  • 可扩展架构：易于将新的MCP服务器添加到集合中
  • TypeScript支持：现代发展，全型安全
  • 生产就绪：构建并测试服务器实现

📁 项目结构

my_mcp_servers/
├── portal/                  # Web portal for managing MCP servers
│   ├── server.js           # Express server
│   ├── package.json        # Portal dependencies
│   └── public/             # Frontend assets
│       ├── index.html      # Main portal interface
│       ├── styles.css      # Modern dark theme styling
│       └── script.js       # Frontend JavaScript
├── servers/                # MCP server implementations
│   └── time-mcp/          # Time and timezone MCP server
│       ├── src/           # TypeScript source code
│       ├── build/         # Compiled JavaScript
│       └── package.json   # Server dependencies
├── clients/               # MCP client implementations
└── README.md             # This file

🛠️ 快速开始

门户设置

  1. 导航到门户目录

    cd portal

  2. 安装依赖项

    npm install

  3. 启动门户

    npm start

  4. 在浏览器中打开

    http://localhost:3000

时间MCP服务器设置

  1. 导航到服务器目录

    cd servers/time-mcp

  2. 安装依赖项

    npm install

  3. 构建服务器

    npm run build

  4. 测试服务器

    npm run inspector

🔧 添加到Claude桌面

自动配置（通过门户）

  1. 打开门户 http://localhost:3000
  2. 找到要添加的服务器
  3. 点击服务器卡上的“复制配置”
  4. 打开克劳德桌面设置
  5. 将配置粘贴到MCP部分
  6. 重新启动克劳德桌面

手动配置

添加到您的Claude Desktop配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
窗户： %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "time-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/my_mcp_servers/servers/time-mcp/build/index.js"]
    }
  }
}

📋 可用服务器

时间MCP服务器

用于时间和时区操作的综合服务器：

工具：

  • get_current_time -获取任何IANA时区的当前时间
  • convert_time -在不同时区之间转换时间
  • get_timezone_info -获取详细的时区信息
  • add_time -从给定的日期时间中添加或减去时间
  • list_common_timezones -列出当前时间的常用时区

提示：

  • time_zone_comparison -生成跨多个时区的比较
  • meeting_scheduler -帮助跨时区安排会议

资源：

  • time://current -当前UTC时间
  • time://zones -所有可用的IANA时区列表

🎯 使用示例

通过门户

  1. 在web界面中浏览可用服务器
  2. 查看服务器详细信息和文档
  3. 复制Claude Desktop的配置
  4. 遵循安装说明

通过克劳德桌面

配置后，您可以使用自然语言：

  • “东京现在几点了？”
  • “将美国东部时间下午3点转换为巴黎时间”
  • “帮我安排一次横跨纽约、伦敦和东京的会议”

🔨 发展

添加新服务器

  1. 在下创建新目录 servers/
  2. 按照MCP规范实现MCP服务器
  3. 添加适当的 package.json 和 README.md
  4. 门户将自动检测并显示您的服务器

门户开发

cd portal
npm run dev  # Development mode with auto-reload

服务器开发

cd servers/time-mcp
npm run dev  # Development mode with TypeScript watching

🧪 测试

门户测试

cd portal
npm start
# Visit http://localhost:3000 to test the interface

服务器测试

cd servers/time-mcp
npm run inspector  # Test with MCP Inspector

📦 依赖项

门户

  • 用于web服务器的Express.js
  • CORS用于跨源请求
  • 现代香草JavaScript前端

时间MCP服务器

  • @MCP实现的modelcontextprotocol/sdk
  • Luxon提供强大的日期/时间处理能力
  • TypeScript用于类型安全

🤝 贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 添加您的MCP服务器或门户增强功能
  4. 彻底测试
  5. 提交拉取请求

服务器贡献指南

  • 遵循MCP规范
  • 包括全面的文件
  • 添加适当的TypeScript类型
  • 提供使用示例
  • 包括适当的错误处理

📚 资源

📄 许可证

MIT许可证-有关详细信息，请参阅单独的package.json文件

🆘 支持

对于问题或疑问：

  1. 检查控制台中的服务器日志
  2. 验证MCP服务器是否正确构建
  3. 确保安装了所有依赖项
  4. 在添加到Claude Desktop之前单独测试服务器

🔮 未来计划

  • 额外的MCP服务器（天气、计算器、文件操作）
  • 服务器模板和脚手架工具
  • 配置验证
  • 服务器测试界面
  • 导出/导入配置
  • 服务器分析和监控

相关 MCP