技能介绍

它解决什么问题

把普通 Python 函数暴露成 MCP 工具，往往意味着手写 mcp.tool() 装饰器、维护模块导入、保证函数签名与参数序列化一致。函数一多，注册代码容易遗漏，签名容易漂移，跑起来才发现某个工具根本没挂上。mcp-tool-maker 想用一次扫描代替手工誊写：给一个 Python 文件，它提取其中的函数，生成规范的 MCP 工具注册代码，最终拼出可直接运行的 mcp_server.py。

核心能力与工作流程

扫描函数：scan_functions(filepath) 读取目标 Python 文件，提取函数签名，作为生成阶段的输入。
生成注册代码：generate_mcp_code(functions, module_name) 基于提取结果产出 mcp.tool() 装饰器包裹的注册代码，保留原函数名与参数结构。
一键产出服务文件：generate_mcp_file(input_py, output_py) 把扫描、生成、拼接串成一步，直接写出 mcp_server.py，无需人工拼接中间产物。
目标探查：list_targets() 列出当前可挂载的 Python 文件，动手前先确认扫描范围，避免把临时脚本误注册成工具。

触发方式直接：告诉 Agent「把这个函数注册成 MCP 工具」「生成 MCP 工具」「扫描一下可注册的函数」，它就会进入上述流程。

适用边界与注意点

它只负责代码生成这一层，不包含 MCP server 的部署、传输层配置或鉴权；生成的 mcp_server.py 仍需在你既有的 MCP 运行环境中启动。
扫描结果是生成的原料，函数能否被正确调用取决于原文件的导入路径、依赖与副作用；存在状态依赖或长耗时逻辑的函数，是否暴露为工具需要自行评估。
生成的注册代码是文本产物，建议纳入版本管理，并在 CI 中检查签名一致性，避免源码改了、注册代码没跟上。