AI导哈

模型上下文协议服务器

MCP服务器是一组用于多种集成的模型上下文协议服务器，提供电子邮件、天气、物联网设备管理、知识库查询、媒体分析和生产力工具等功能。

  • by bvdiep
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 bvdiep/mcp-servers

使用说明

MCP服务器

用于各种集成的模型上下文协议（MCP）服务器集合。

可用服务器

模块 描述 工具
mcp_communication 电子邮件、天气和时间 read_emails、get_weather_forecast、get_current_time
mcp_iot 物联网设备管理（ThingsBoard） set_attributes_light、get_telemetry_data、get_all_devices
mcp_knowledge 知识库（RAGFlow、Serper） 查询知识、搜索网站
mcp_media_analytics 照片（Immich）和BI（元数据库） query_photo、check_attendence、get_ai_review_data
mcp_productivity 项目（OpenProject）和日程安排 get_print_overview、add_schedule、get_schedules_this_week

快速开始

安装

每个服务器都有自己的依赖关系。单独安装它们：

# For each server
cd mcp_<module>
pip install -r requirements.txt

配置

大多数服务器使用环境变量进行配置。复制示例或将其设置在您的环境中：

# Email (mcp_communication)
export EMAIL_IMAP_SERVER="imap.zoho.com"
export EMAIL_USERNAME="your@email.com"
export EMAIL_APP_PASSWORD="your_app_password"
export OPENWEATHER_API_KEY="your_api_key"

# ThingsBoard (mcp_iot)
export THINGSBOARD_URL="https://your-instance.io"
export THINGSBOARD_USERNAME="your_username"
export THINGSBOARD_PASSWORD="your_password"

# RAGFlow (mcp_knowledge)
export RAGFLOW_API_KEY="your_ragflow_api_key"
export SERPER_API_KEY="your_serper_api_key"

# Immich (mcp_media_analytics)
export IMMICH_URL="https://your-immich-instance.com"
export IMMICH_USERNAME="your_username"
export IMMICH_PASSWORD="your_password"
export IMMICH_ALBUM_ID="your_album_id"

# Metabase (mcp_media_analytics)
export BI_API_KEY="your_metabase_api_key"
export BI_BASE_URL="https://your-metabase.com"

# OpenProject (mcp_productivity)
export OP_API_KEY="your_api_key"
export OP_BASE_URL="https://project.bsmlabs.ai"

运行服务器

cd mcp_<module>
python server.py

建筑

每个MCP服务器都遵循一致的结构：

mcp_<module>/
├── __init__.py          # Package initialization
├── config.py             # Configuration (environment variables)
├── server.py             # MCP server implementation
├── README.md             # Module documentation
├── requirements.txt      # Python dependencies
└── *_adapter.py          # External service adapters

发展

添加新服务器

  1. 创建一个新目录 mcp_<name>/
  2. 实现外部服务的适配器类
  3. 创建 server.py 遵循MCP服务器模式
  4. 添加 config.py 用于环境变量配置
  5. 创建 requirements.txt 有依赖关系
  6. 将模块文档添加到此README中

相关 MCP