AM

agentiqs/mcp-kit-python

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

23 stars 2 forks 质量 39 趋势 10NOASSERTION

Agentiqs.ai MCP-套件

概览

============================= 一套用于使用模型上下文协议(MCP)的全面工具包,提供AI代理与各种数据源、API和服务之间的无缝集成。无论您是在构建、测试还是部署多代理系统,MCP Kit都能简化工具编排的复杂性,并为开发提供强大的模拟功能。 - : 连接现有MCP服务器(托管或规范) - : 自动将REST API转换为使用OpenAPI/Swagger规范的MCP工具 - : 使用LLM或随机生成器生成逼真的测试数据 - : 将多个目标结合为统一界面 - : 原生集成 OpenAI 代理框架 - : LangGraph 工作流程无缝工具集成 - : 直接 MCP 协议通信 - : 标准 MCP 服务器包装 - :为复杂工作流提供声明式设置 - :干净且可测试的组件创建 - :安全的凭证管理 - : 生成上下文合适的响应,使用......

概述(AI 翻译)

MCP工具用于开发和优化多智能体AI系统

============================= 一套全面的工具包,用于使用模型上下文协议(MCP),实现AI代理与各种数据源、API和服务之间的无缝集成。无论你是在构建、测试还是部署多代理系统,MCP Kit都能简化工具编排的复杂性,并为开发提供强大的模拟功能。

特色

灵活目标系统

  • MCP 服务器:连接现有 MCP 服务器(托管或规范)
  • OpenAPI 集成:自动将 REST API 转换为使用 OpenAPI/Swagger 规范的 MCP 工具
  • 模拟回答:使用大型语言模型(LLM)或随机生成器生成真实的测试数据
  • 复用:将多个目标合并为统一接口

框架适配器

  • OpenAI 代理 SDK:原生集成于 OpenAI 代理框架
  • LangGraph:LangGraph工作流程的无缝工具集成
  • 通用客户端会话:直接MCP协议通信
  • 官方MCP服务器:标准MCP服务器包装器

配置驱动架构

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

MCP Kit Python

MCP tooling for developing and optimizing multi-agent AI systems

A comprehensive toolkit for working with the Model Context Protocol (MCP), providing seamless integration between AI agents and various data sources, APIs, and services. Whether you’re building, testing, or deploying multi-agent systems, MCP Kit simplifies the complexity of tool orchestration and provides powerful mocking capabilities for development.

Features

Flexible Target System

  • MCP Servers: Connect to existing MCP servers (hosted or from specifications)
  • OpenAPI Integration: Automatically convert REST APIs to MCP tools using OpenAPI/Swagger specs
  • Mock Responses: Generate realistic test data using LLM or random generators
  • Multiplexing: Combine multiple targets into a unified interface

Framework Adapters

  • OpenAI Agents SDK: Native integration with OpenAI’s agent framework
  • LangGraph: Seamless tool integration for LangGraph workflows
  • Generic Client Sessions: Direct MCP protocol communication
  • Official MCP Server: Standard MCP server wrapper

Configuration-Driven Architecture

  • YAML/JSON Configuration: Declarative setup for complex workflows
  • Factory Pattern: Clean, testable component creation
  • Environment Variables: Secure credential management

Advanced Response Generation

  • LLM-Powered Mocking: Generate contextually appropriate responses using LLMs
  • Random Data Generation: Create test data for development and testing
  • Custom Generators: Implement your own response generation logic

Quick Start

Installation

uv add mcp-kit

Basic Usage

First you write the Proxy config:

# proxy_config.yaml
""" A mocked REST API target given the OpenAPI spec using LLM-generated responses
"""
target:
  type: mocked
  base_target:
    type: oas
    name: base-oas-server
    spec_url: https://petstore3.swagger.io/api/v3/openapi.json
  tool_response_generator:
    type: llm
    model: openai/gpt-4.1-nano

Don’t forget to setup the LLM API KEY:

# .env
OPENAI_API_KEY="your_openai_key"

Then we can use it as any other MCP:

# main.py
from mcp_kit import ProxyMCP

async def main():
    # Create proxy from configuration
    proxy = ProxyMCP.from_config("proxy_config.yaml")

    # Use with MCP client session adapter
    async with proxy.client_session_adapter() as session:
        tools = await session.list_tools()
        result = await session.call_tool("get_pet", {"pet_id": "777"})
        print(result)

if __name__ == "__main__":
    import asyncio
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →