AI导哈

MCP服务器

clearskies MCP服务器为AI助手提供代码生成、文档和项目脚手架工具，适用于clearskies Python框架的应用开发。

  • by clearskies-py
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 clearskies-py/mcp-server

使用说明

clearskys MCP服务器

MCP（模型上下文协议）服务器 晴空 Python框架。该服务器为AI助手提供了代码生成、文档和项目脚手架的工具，以便在使用clearsky构建应用程序时使用。

安装

pip install clear-skies-mcp-server

或者使用紫外线：

uv pip install clear-skies-mcp-server

特性

文档工具

核心类型发现

工具 说明
list_available_columns 列出所有可用的晴空柱类型
list_available_endpoints 列出所有可用的端点类型
list_available_backends 列出所有可用的后端类型
list_available_contexts 列出所有可用的上下文类型
get_column_info 获取特定列类型的详细文档
get_endpoint_info 获取特定端点类型的详细文档
get_backend_info 获取特定后端类型的详细文档
get_context_info 获取特定上下文类型的详细文档

扩展类型发现

工具 说明
list_available_authentication 列出所有身份验证类型（SecretBearer、JWKS等）
list_available_validators 列出所有验证器类型（必需、唯一等）
list_available_exceptions 列出所有异常类型
list_available_di_inject 列出所有DI注入助手
list_available_cursors 列出所有光标类型
list_available_input_outputs 列出所有输入/输出处理程序
list_available_configs 列出所有配置类型
list_available_clients 列出所有客户端类型
list_available_secrets 列出所有机密处理程序
list_available_security_headers 列出所有安全标头处理程序
list_available_query 列出所有查询生成器类型
list_available_query_results 列出所有查询结果类型
list_available_functional 列出所有功能实用程序

扩展类型信息

工具 说明
get_authentication_info 获取特定身份验证类型的详细文档
get_validator_info 获取特定验证器类型的详细文档
get_exception_info 获取特定异常类型的详细文档
get_di_inject_info 获取特定DI注入助手的详细文档
get_cursor_info 获取特定光标类型的详细文档
get_input_output_info 获取特定输入/输出处理程序的详细文档
get_config_info 获取特定配置类型的详细文档
get_client_info 获取特定客户类型的详细文档
get_secret_info 获取特定机密处理程序的详细文档
get_security_header_info 获取特定安全标头处理程序的详细文档
get_query_info 获取特定查询生成器类型的详细文档
get_query_result_info 获取特定查询结果类型的详细文档
get_functional_info 获取特定功能实用程序的详细文档

概念解释

工具 说明
explain_concept 详细解释任何晴空概念

代码生成工具

工具 说明
generate_model 生成晴空模型类定义
generate_endpoint 生成端点配置
generate_context 生成包裹端点的上下文
generate_endpoint_group 生成端点组配置

脚手架工具

工具 说明
scaffold_project 使用多个模型生成完整的晴空项目
scaffold_restful_api 为单个模型生成完整的REST API应用程序
generate_model_with_relationships 生成具有关系的多个相关模型

文献资源

核心文件

资源URI 描述
clearskies://docs/overview 框架概述
clearskies://docs/models 模型文档
clearskies://docs/endpoints 端点文档
clearskies://docs/columns 列类型文档
clearskies://docs/backends 后端文档
clearskies://docs/contexts 上下文文档
clearskies://docs/di 依赖注入文档
clearskies://docs/authentication 身份验证文档
clearskies://docs/save-lifecycle 保存生命周期文档
clearskies://docs/queries 查询文档
clearskies://docs/validators 验证器文档

扩展文档

资源URI 描述
clearskies://docs/testing 测试晴空应用程序
clearskies://docs/authorization 授权模式
clearskies://docs/error-handling 错误处理
clearskies://docs/input-handling 输入处理
clearskies://docs/endpoint-groups 端点组
clearskies://docs/routing 路线文件
clearskies://docs/responses 响应定制
clearskies://docs/migrations 数据库迁移（迁移）
clearskies://docs/advanced-columns 高级列类型
clearskies://docs/advanced-queries 高级查询模式
clearskies://docs/configuration 配置管理
clearskies://docs/logging 日志记录和可观察性
clearskies://docs/caching 缓存模式
clearskies://docs/async 异步模式
clearskies://docs/state-machine-advanced 高级状态机模式
clearskies://docs/secrets-backend 机密后端

后端深度跳水

资源URI 描述
clearskies://docs/backend-memory 内存后端深度挖掘
clearskies://docs/backend-cursor Cursor后端深潜
clearskies://docs/cursors 游标和原始SQL
clearskies://docs/transactions 交易管理

框架内部

资源URI 描述
clearskies://docs/di-advanced 高级DI模式
clearskies://docs/query-execution 查询执行模型
clearskies://docs/model-lifecycle 模型生命周期
clearskies://docs/input-output 输入/输出系统

开发者体验

资源URI 描述
clearskies://docs/troubleshooting 故障排除指南
clearskies://docs/best-practices 最佳做法
clearskies://docs/exceptions 异常层次结构引用
clearskies://docs/auth-flow 认证流程文档

参考资料

资源URI 描述
clearskies://docs/column-reference 完整的列参数参考
clearskies://docs/endpoint-reference 完整的端点参数参考
clearskies://docs/performance 性能指南
clearskies://docs/patterns 常见模式烹饪书

示例资源

资源URI 描述
clearskies://examples/restful-api 完整的REST API示例
clearskies://examples/relationships 模型关系示例
clearskies://examples/authentication 经过身份验证的API示例
clearskies://examples/cli-app CLI应用程序示例
clearskies://examples/api-backend API客户端（ApiBackend）示例
clearskies://examples/testing 测试示例
clearskies://examples/authorization 授权模式示例
clearskies://examples/error-handling 错误处理示例
clearskies://examples/endpoint-group 端点组示例
clearskies://examples/migrations 数据库迁移示例
clearskies://examples/hierarchical-data 分层数据（类别树）示例
clearskies://examples/audit-trail 审计跟踪示例
clearskies://examples/pivot-data 以枢轴数据为例的多对多
clearskies://examples/advanced-queries 高级查询模式示例
clearskies://examples/configuration 配置管理示例
clearskies://examples/state-machine-advanced 高级状态机示例
clearskies://examples/secrets-backend Secrets后端示例

模块资源

资源URI 描述
clearskies://modules/overview 所有扩展模块概述
clearskies://modules/aws 晴空自动气象站模块
clearskies://modules/graphql clearskysgraphql模块
clearskies://modules/gitlab 晴空数字信号实验室模块
clearskies://modules/cortex 晴空皮质模块
clearskies://modules/snyk 晴空snyk模块
clearskies://modules/akeyless 晴空无灰定制生产模块

风格资源

资源URI 描述
clearskies://style/docstrings Docstring风格指南

MCP配置

将此添加到您的MCP设置中（例如在Kilo Code、Claude Desktop等中）：

{
    "mcpServers": {
        "clearskies": {
            "command": "clear-skies-mcp-server",
            "args": []
        }
    }
}

或者，如果使用紫外线/紫外线：

{
    "mcpServers": {
        "clearskies": {
            "command": "uvx",
            "args": ["clear-skies-mcp-server"]
        }
    }
}

发展

# Clone the repo
git clone https://github.com/clearskies-py/mcp-server.git
cd mcp-server

# Create venv and install dependencies
uv sync all-extras --all-groups

# Run the server
clear-skies-mcp-server

许可证

麻省理工学院

相关 MCP