mcp_input_analyzer

mcp_input_analyzer

简介

mcp_input_analyzer 是一个功能强大的开源库，旨在分析用户描述的构建功能，例如数据库、API 集成和工具。该库的主要目标是提取核心服务需求，包括 MCP（微服务配置平台）所需的资源、工具、提示词、外部系统和传输方式。此工具可确保清晰、结构化地定义项目的依赖项和配置。

功能

• 将自然语言转换为结构化的构建功能提取结果：将自由格式的构建功能描述转换为结构化格式。
• 生成符合 MCP 规范的输入结构：生成符合 MCP 规范的输入结构，确保与 MCP 平台兼容。
• 验证受支持的工具和协议：验证指定的工具和协议是否受该库支持。
• 创建 Claude 可读的 JSON 定义：创建便于 Claude 或类似系统读取和处理的 JSON 定义。
• 对不受支持的功能提供回退逻辑：提供回退机制，以妥善处理不受支持的构建功能。

安装说明

要安装 mcp_input_analyzer，需要在系统上安装 Python 3.6+。然后可以通过 pip 安装该库：

pip install mcp-input-analyzer

或者，如果你希望克隆代码仓库并从源代码安装，请按以下步骤操作：

git clone https://github.com/your-repo/mcp_input_analyzer.git
cd mcp_input_analyzer
pip install .

使用示例

示例 1：基本功能提取

from mcp_input_analyzer import MCPAnalyzer

# Initialize the analyzer with a sample description
description = """
We need to integrate an API for user authentication and a PostgreSQL database.
Also, we require Redis for caching and a custom logging tool for monitoring.
"""

analyzer = MCPAnalyzer(description)
requirements = analyzer.extract_requirements()

print(requirements)

示例 2：生成符合 MCP 规范的输入结构

from mcp_input_analyzer import MCPAnalyzer

description = """
We need to integrate an API for user authentication and a PostgreSQL database.
Also, we require Redis for caching and a custom logging tool for monitoring.
"""

analyzer = MCPAnalyzer(description)
mcp_compliant_structure = analyzer.generate_mcp_structure()

print(mcp_compliant_structure)

示例 3：创建 Claude 可读的 JSON 定义

from mcp_input_analyzer import MCPAnalyzer

description = """
We need to integrate an API for user authentication and a PostgreSQL database.
Also, we require Redis for caching and a custom logging tool for monitoring.
"""

analyzer = MCPAnalyzer(description)
claude_json_definition = analyzer.create_claude_json()

print(claude_json_definition)

API 文档

MCPAnalyzer

该库的主类。

• 初始化：

  MCPAnalyzer(description: str, fallback_behavior='default')
  

  • description：描述构建功能的字符串。
  • fallback_behavior：可选。指定对不受支持功能的处理方式（'default' 或 'custom'）。

• 方法：

  • extract_requirements()：

    • 返回一个字典，其中包含从描述中提取的结构化服务需求。

  • generate_mcp_structure()：

    • 根据需求生成并返回符合 MCP 规范的输入结构。

  • create_claude_json()：

    • 创建并返回服务需求的 Claude 可读 JSON 定义。

许可证

mcp_input_analyzer 采用 MIT 许可证发布。更多详情请参阅 LICENSE 文件。

---

感谢使用 mcp_input_analyzer！我们欢迎社区贡献，让此工具变得更加出色。欢迎在我们的 GitHub 代码仓库中提出问题或提交拉取请求。

⚠️ 开发状态

此库目前处于早期开发阶段。某些测试可能会因以下问题而失败：

欢迎贡献代码来修复这些问题！如果你有解决方案，请提交拉取请求。