优秀的编程知识分享平台

网站首页 > 技术文章 正文

技巧 | 往MCP服务器添加提示词模板

nanyue 2025-07-19 21:32:44 技术文章 4 ℃

在我的上一篇文章[1]中,我已经构建了一个本地MCP服务器并向其添加了一些工具。在本文中,我们将向该MCP服务器添加提示词。

这是如同上一篇博客的文件结构。但在这里,我为此创建了两个新文件。

.
├──  venv/
├──  helpers.py
├──  server.py
├──  prompts.py          
├──  prompt_builder.py   
└──  tools.py

如果你尚未设置环境,请按照我在上一篇博客中提到的方式设置开发环境。之后你可以从这里继续。在本教程中,我创建两个提示词,并将它们添加到MCP服务器中。然后在Claude Desktop中使用它们

1.创建提示词

我将创建一个用于修复代码中bug的提示和另一个用于优化文本的提示。首先,让我们看一个MCP提示的示例,以了解MCP提示的结构。

from mcp.server.fastmcp.prompts import Prompt
from mcp.server.fastmcp.prompts.base import PromptArgument

example_prompt = Prompt(
    name="PROMPT_NAME",
    description="PROMPT_DESCRIPTION",
    arguments=[
        PromptArgument(
            name="ARGUMENT_NAME",
            description="ARGUMENT_DESCRIPTION",
            required="OPTIONAL_OR_REQUIRED"
        )
    ],
    fn="FUNCTION_FOR_BUILDING_THE_PROMPT"
)

提示参数就像提示中的占位符。用户在Claude Desktop中使用提示时可以为这些值提供输入。一个提示可以有多个提示参数或零个参数。此外,我们可以通过更改required参数的值来设置提示参数是必需的还是可选的。

好的。现在你对MCP提示的结构有了了解。让我们创建我们的提示。第一个是优化文本。这个提示的功能是,当我们向Claude Desktop提供一些文本时,它会优化该文本。这个提示没有参数。

from mcp.server.fastmcp.prompts import Prompt
from mcp.server.fastmcp.prompts.base import PromptArgument
from prompt_builder import PromptBuilder

text_refinement_prompt = Prompt(
    name="refine-the-text",
    description="Refine the given text",
    arguments=[],
    fn=PromptBuilder.text_refinement_prompt_fn,
)

现在让我们创建第二个提示。这个提示有两个参数。这个提示用于修复给定代码片段中的错误。第一个参数是输入所使用的框架。这个参数是必需的。第二个是一个可选参数,用于输入错误信息。

bugfix_prompt = Prompt(
    name="fix-the-issue",
    description="Fix the issue in the give code snippet",
    arguments=[
        PromptArgument(
            name="framework",
            description="The framework used in the code snippet",
            required=True
        ),
        PromptArgument(
            name="issue",
            description="The issue in the code snippet"
        ),
    ],
    fn=PromptBuilder.bugfix_prompt_fn
)

好的,我们已经完成了提示的创建,但我们还没有创建提示函数。

2.创建提示词函数

让我们创建一个PromptBuilder类并在其中定义提示函数。这些函数不一定需要在类内部,但我更喜欢以这种方式组织代码,以便更好地管理。

from textwrap import dedent


class PromptBuilder:

    @staticmethod
    def text_refinement_prompt_fn():
        return dedent(
            f"""
            Rewrite the given text for grammar errors. 
            Make it more readable. 
            But don't change the meaning and writing style.
            """
        )

    @staticmethod
    def bugfix_prompt_fn(framework, issue=""):
        return dedent(
            f"""
            Act as a experienced {framework} developer. 
            Study the given code and fix the bug. 
            Bug: {issue}
            """
        )    

第一个函数生成"refine-the-text"提示,它不需要任何参数。因此,该函数本身没有参数,只是简单地返回要提供给LLM的提示。第二个函数构建"fix-the-issue"提示,它接受两个参数,一个是必需的,一个是可选的。相应地,该函数有两个参数,第一个是必需的,第二个是可选的,与提示结构保持一致。这些参数使用f-string插入到提示中的占位符中。实际上,这些提示函数负责动态构建最终提示。

3.附加到MCP服务器

现在,让我们将我们的提示添加到上一篇文章[2]中创建的服务器。

from mcp.server.fastmcp import FastMCP
from prompts import bugfix_prompt, text_refinement_prompt


mcp = FastMCP("Weather-Server")


mcp.add_prompt(bugfix_prompt)
mcp.add_prompt(text_refinement_prompt)
if __name__ == "__main__":
    
    mcp.run()

4.连接到Claude Desktop

JSON配置不需要更改。与之前相同的配置。创建一个JSON配置文件。在以下位置创建一个JSON文件。C:\Users\USER>\AppData\Roaming\Claude\claude_desktop_config.json

{
    "mcpServers": {
        "weather": {
            
            
            "command": "<PATH_TO_ENVIRONMENT>\\venv\\Scripts\\python",
            "args": [
                
                "<PATH_TO_SERVER>\\server.py" 
            ]
        }
    }
}

我已经在上一篇文章[3]中解释了这个配置。所以,我不会在本文中再次解释。创建配置文件后,重新启动Claude Desktop。

重新启动Claude Desktop后,你可以看到一个名为"Attach from MCP"的按钮。点击它。然后点击"Choose an integration"。

在这个下拉菜单中,你可以看到你在MCP中创建的提示都列在这里。现在让我们看看如何使用它们。首先,让我们尝试fix-the-issue提示。如果你点击它,你会看到这样的弹出窗口

它会要求你填写你在提示中定义的提示参数。填写这些参数并提交。它将作为附件添加到Claude Desktop。现在你可以在聊天输入框中给出剩余的提示。

其他MCP提示也类似。唯一的区别是它们不要求参数。它们会立即作为附件添加到聊天中。

5.总结

我们可以将这些MCP提示词用作模板。如果你使用Claude Desktop执行重复性任务,可以创建MCP提示词模板。这样,你就不需要手动输入提示词。你可以简单地从MCP服务器检索它。此外,你可以将所有提示词存储在一个集中位置。

引用链接

[1] 上一篇文章: https://medium.com/stackademic/build-simple-local-mcp-server-5434d19572a4
[2] 上一篇文章:
https://medium.com/stackademic/build-simple-local-mcp-server-5434d19572a4
[3] 上一篇文章:
https://medium.com/stackademic/build-simple-local-mcp-server-5434d19572a4

Tags:

最近发表
标签列表