项目介绍

欢迎来到MCP（多功能计算平台）的官方文档。本指南将帮助您了解如何安装、配置和使用MCP框架。

模型上下文

模型上下文是实现自定义业务逻辑的核心部分。它接收输入参数并返回处理结果。

功能概述

• 基本功能：执行简单的算术运算。
• 扩展功能：支持复杂的数学计算，如幂运算、平方根和对数。

示例代码

# 加法示例
result = execute({
    "name": "calculator",
    "parameters": {
        "operation": "add",
        "a": 5,
        "b": 3
    }
})
print(f"加法结果：{result}")  # 输出：8

# 平方根示例
sqrt_result = execute({
    "name": "calculator",
    "parameters": {
        "operation": "sqrt",
        "a": 16
    }
})
print(f"平方根结果：{sqrt_result}")  # 输出：4.0

MCP框架

MCP是一个功能强大的工具链，支持多种功能的组合与扩展。

核心组件

• 执行器：负责调用并管理工具执行。
• 工具注册与发现：自动检测和注册可用工具。

示例代码

from mcp_example.core.executor import execute

# 调用计算器工具
result = execute({
    "name": "calculator",
    "parameters": {
        "operation": "multiply",
        "a": 2,
        "b": 8
    }
})
print(f"乘法结果：{result}")  # 输出：16

# 调用文本处理工具
text_result = execute({
    "name": "transform_text",
    "parameters": {
        "operation": "uppercase",
        "text": "hello world"
    }
})
print(f"转换后的文本：{text_result}")  # 输出：HELLO WORLD

工具链接

工具链接允许将多个工具串联起来，形成复杂的处理流程。

直接链接示例

from mcp_example.core.executor import execute

# 步骤1：调用计算器工具计算总和
sum_result = execute({
    "name": "calculator",
    "parameters": {
        "operation": "add",
        "a": 10,
        "b": 20
    }
})

# 步骤2：使用结果作为文本处理的输入
text_result = execute({
    "name": "transform_text",
    "parameters": {
        "operation": "prepend",
        "text": "总和为：",
        "append_text": str(sum_result)
    }
})

print(f"最终输出：{text_result}")  # 输出：总和为：30

代理工具

代理工具允许将函数调用转发到远程MCP服务器，实现透明访问。

示例代码

from mcp_example.core.executor import execute
from mcp_example.tools.proxy import register_proxy

# 注册代理服务
register_proxy("http://remote.mcp-server.com:5000")

# 调用远程计算器工具
result = execute({
    "name": "calculator",
    "parameters": {
        "operation": "subtract",
        "a": 20,
        "b": 10
    }
})

print(f"减法结果：{result}")  # 输出：10

可用工具

计算器工具（Calculator）

• 功能：支持加、减、乘、除等基本运算。
• 高级功能：幂运算、平方根和对数计算。

示例代码

# 多功能计算器示例
operations = {
    "add": 5 + 3,
    "subtract": 5 - 3,
    "multiply": 5 * 3,
    "divide": 5 / 3,
    "power": 2 ** 3,
    "sqrt": 16 ** 0.5,
    "log": 10 ** math.log10(10)
}

for op, result in operations.items():
    print(f"{op} 结果：{execute({\"name\": \"calculator\", \"parameters\": {{\"operation\": \"{op}\", \"a\": {operations[op]}}})}")

贡献指南

参与项目

欢迎任何人参与MCP框架的开发！您可以通过以下方式贡献：

1. 报告问题：在GitHub仓库提交问题。
2. 功能请求：提出新功能或改进建议。
3. 代码贡献：为框架添加新功能或修复问题。

提交指南

• 请确保代码符合PEP8规范。
• 提交时，请附带详细的变更说明。
• 签订贡献者协议前，请阅读相关条款。

许可证

本项目遵循MIT许可证，具体内容如下：

MIT License

版权 © [年份] [作者姓名]

特此许可任何人免费使用、复制、修改、合并、发布、分发和/或销售本软件及其衍生作品，但需在所有副本中保留上述版权声明和本许可声明。

对于本软件及其衍生作品，DISCLAIMER OF WARRANTY：该软件按“原样”提供，不附带任何明示或暗示的保证，包括但不限于适销性、适合特定用途或无侵权的保证。

联系方式

• 邮件：contact@mcplatform.org
• GitHub：https://github.com/mcplatform
• 论坛：https://forum.mcplatform.org

感谢您选择MCP框架！希望本指南能帮助您顺利完成项目开发。