使用说明
模板--Echo工具和开发模板
写作新的起点 服务器已生成 工具
回显文本。测试工具基础设施。新工具模板。 简单、有文档记录、可克隆。
这是什么类型的工具？
此模板适用于SERVER-SPOWNED工具 --MCP-Link服务器直接启动和管理的工具。
服务器共享工具（此模板）
当您的工具执行以下操作时，请使用此模板：
- ✅ 作为MCP Link服务器进程的一部分运行
- ✅ 可以由服务器启动/停止
- ✅ 不需要访问外部应用程序
- ✅ 适用于Python和标准库
示例： SQLite、Python执行器、系统信息、天气、嵌入
外部工具（改用远程元工具）
不要使用此模板 如果您的工具需要：
- ❌ 在另一个应用程序（Chrome、Fusion 360、Cura等）中运行
- ❌ 保持持续会话（WhatsApp Web、浏览器登录）
- ❌ 仅在特定环境中可用的访问API
- ❌ 以与服务器不同的语言/运行时运行
有关外部工具，请参阅： 远程工具注册
外部工具示例：
- Chrome 扩展 --必须在实际浏览器中运行
- Fusion 360插件 --必须在Autodesk Fusion 360中运行
- WhatsApp服务 --必须保持持久的WhatsApp Web会话
- 获取插件 --必须在Ultimaker Cura内运行
这些工具 重新连接 使用反向连接连接到服务器。请参阅 远程MCP文档 用于6种语言（Python、JavaScript、Go、Java、Kotlin、Perl）的完整实现。
益处
1.🧪 基础设施测试
不是生产工具，而是测试工具。 验证工具调用是否正常，测试参数传递，调试MCP集成。对发展至关重要。
2.📋 开发模板
不仅仅是echo——服务器衍生工具的蓝图。 MCP工具结构、令牌系统、参数验证、错误处理的完整示例。复制和自定义。
3.✅ 参数验证示例
不是最小的代码——生产模式。 显示正确的验证、错误处理和文档结构。以身作则。
为什么这个工具很重要
测试工具基础设施至关重要。 在构建复杂的工具之前，请验证基础工作。可以调用工具吗？参数是否正确传递？回复的格式是否正确？
创建新的服务器衍生工具需要样板。 令牌生成、参数验证、错误处理、文档结构——每个工具都需要这些模式。
该工具提供了这两种功能。 使用它来测试基础设施。克隆它以创建新的服务器衍生工具。包括生产就绪模式。
选择正确的方法
决策树：我需要哪个模板？
问问自己： “MCP Link服务器可以直接启动我的工具吗？”
YES → 使用此模板（服务器共享）
在以下情况下，您的工具可以由服务器生成：
- 它是用Python编写的
- 它使用标准库或pip可安装包
- 它不需要访问外部应用程序
- 它可以作为服务器进程的一部分运行
克隆此模板并对其进行自定义。
NO → 使用远程工具注册
在以下情况下，您的工具需要反向连接：
- 它必须在另一个应用程序（浏览器、CAD软件、IDE等）中运行
- 它需要保持持久会话（登录浏览器、WhatsApp Web）
- 它是用另一种语言编写的（JavaScript、Go、Java、Kotlin、C++、Perl）
- 它需要访问仅在特定环境中可用的API
看 远程MCP 对于完整的实现。
真实世界的例子
| 工具 | 类型 | 为什么？ |
|---|---|---|
| SQLite | 服务器共享 | Python库，无外部依赖 |
| Python执行器 | 服务器共享 | 在服务器进程中运行Python代码 |
| 系统信息 | 服务器共享 | 使用标准Python库 |
| Weather API | 服务器暂停 | 通过Python的HTTP请求 |
| Chrome 扩展 | 远程 | 必须在实际浏览器中运行 |
| Fusion 360插件 | 远程 | 必须在Fusion 360内运行 |
| WhatsApp服务 | 远程 | 保持持续会话 |
| 获取插件 | 远程 | 必须在Cura内奔跑 |
体系结构比较
服务器已共享（此模板）：
┌─────────────────────────────────────┐
│ MCP-Link Server │
│ │
│ ┌─────────────────────────────┐ │
│ │ Your Tool (Python) │ │
│ │ - Runs in server process │ │
│ │ - Started by server │ │
│ │ - Direct function calls │ │
│ └─────────────────────────────┘ │
└─────────────────────────────────────┘
↕
┌─────────────────────────────────────┐
│ AI Agent (Cursor, Claude, etc.) │
└─────────────────────────────────────┘
外部工具（远程注册）：
┌─────────────────────────────────────┐
│ External Application │
│ (Chrome, Fusion 360, etc.) │
│ │
│ ┌─────────────────────────────┐ │
│ │ Your Tool │ │
│ │ - Runs in application │ │
│ │ - Connects back to server │ │
│ │ - Reverse connection │ │
│ └─────────────────────────────┘ │
└─────────────────────────────────────┘
↕ SSE + HTTPS
┌─────────────────────────────────────┐
│ MCP-Link Server │
│ - Routes calls to external tool │
└─────────────────────────────────────┘
↕
┌─────────────────────────────────────┐
│ AI Agent (Cursor, Claude, etc.) │
└─────────────────────────────────────┘
完整的功能集
回声操作
基本回声：
# Echo text back
result = echo(text="Hello, World!")
# Returns: "Hello, World!"
为什么回声很重要： 尽可能简单的操作。如果echo正常工作，则工具基础设施正常工作。非常适合调试。
模板结构
包括：
- 令牌生成系统
- 参数验证
- 错误处理
- 文件格式
- 示例用法
- 经办人注册
克隆和自定义新工具。
用法示例
回声文本
{
"input": {
"operation": "echo",
"text": "Test message",
"tool_unlock_token": "YOUR_TOKEN"
}
}
技术架构
令牌系统
- 基于HMAC的安全令牌
- 具体安装
- 防止未经授权的使用
- 强制阅读文档
参数验证
- 基于模式的验证
- 类型检查
- 所需的现场执行
- 有用的错误消息
错误处理
- 全面试捕
- 详细的错误消息
- 可选文档包含
- 一致的响应格式
为什么此模板不匹配
1.测试工具
在构建复杂的服务器衍生工具之前，验证工具基础架构是否正常工作。
2.开发模板
生产就绪服务器生成工具结构的完整示例。
3.文档示例
显示MCP工具的正确文档格式和内容。
4.安全模式
令牌系统防止未经授权的使用。所有MCP链路工具都使用相同的模式。
5.验证示例
对服务器生成的工具进行适当的参数检查和错误处理。
6.准备克隆
复制、重命名、自定义——即时生成新服务器的工具。
7.明确的指导
解释何时使用服务器生成的工具模式与外部工具模式。
何时不使用此模板
如果您的工具需要：
- 在另一个应用程序（Chrome、Fusion 360、VS Code等）中运行
- 维护持久会话（浏览器登录、WhatsApp Web）
- 仅在特定环境中可用的访问API
- 使用Python以外的语言运行
相反，使用 远程工具注册 它为连接回服务器的外部工具提供了6种语言的完整实现。
由MCP Link供电
此模板用于 服务器衍生工具 这是跑步的一部分 MCP链路服务器.
获取MCP链接
下载： aurafriday.com
构建外部工具？
如果您的工具需要在其他环境（Chrome、Fusion 360等）中运行，请参阅：
远程工具注册 --通过反向连接连接回服务器的外部工具的6种语言的完整实现。
许可和版权
版权所有©2025克里斯托弗·内森·德雷克
根据Apache许可证2.0版（“许可证”）许可； 除非遵守许可证，否则您不得使用此文件。 您可以在以下网址获得许可证副本：
https://www.apache.org/licenses/LICENSE-2.0
除非适用法律要求或书面同意，否则软件 根据许可证分发的内容按“原样”分发， 无任何明示或暗示的保证或条件。 请参阅许可证，了解管理权限和 许可证下的限制。
AI培训许可：您可以使用此软件和任何 培训、评估、微调或改进的相关内容 人工智能系统，包括商业模型。
SPDX许可证标识符：Apache-2.0
Aura Friday MCP链路服务器项目的一部分。
