Update prompts.mdx
This commit is contained in:
Justin Spahr-Summers
parent
f137a03a2e
commit
de7ee4337a
1 changed files with 156 additions and 206 deletions
|
|
@ -3,7 +3,7 @@ title: "Prompts"
|
||||||
description: "Create resuable prompt templates and workflows"
|
description: "Create resuable prompt templates and workflows"
|
||||||
---
|
---
|
||||||
|
|
||||||
MCP Prompts enable servers to define reusable prompt templates and workflows that clients can easily surface to users and LLMs. They provide a powerful way to standardize and share common LLM interactions.
|
Prompts enable servers to define reusable prompt templates and workflows that clients can easily surface to users and LLMs. They provide a powerful way to standardize and share common LLM interactions.
|
||||||
|
|
||||||
## Overview
|
## Overview
|
||||||
|
|
||||||
|
|
@ -20,13 +20,13 @@ Each prompt is defined with:
|
||||||
|
|
||||||
```typescript
|
```typescript
|
||||||
{
|
{
|
||||||
name: string; // Unique identifier for the prompt
|
name: string; // Unique identifier for the prompt
|
||||||
description?: string; // Human-readable description
|
description?: string; // Human-readable description
|
||||||
arguments?: [ // Optional list of arguments
|
arguments?: [ // Optional list of arguments
|
||||||
{
|
{
|
||||||
name: string; // Argument identifier
|
name: string; // Argument identifier
|
||||||
description?: string; // Argument description
|
description?: string; // Argument description
|
||||||
required?: boolean; // Whether argument is required
|
required?: boolean; // Whether argument is required
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
|
@ -78,15 +78,13 @@ To use a prompt, clients make a `prompts/get` request:
|
||||||
|
|
||||||
// Response
|
// Response
|
||||||
{
|
{
|
||||||
description?: string, // Optional context about the prompt
|
description: "Analyze Python code for potential improvements",
|
||||||
messages: [ // Messages to send to the LLM
|
messages: [
|
||||||
{
|
{
|
||||||
role: "user" | "assistant",
|
role: "user",
|
||||||
content: {
|
content: {
|
||||||
type: "text" | "image",
|
type: "text",
|
||||||
text?: string,
|
text: "Please analyze the following Python code for potential improvements:\n\n```python\ndef calculate_sum(numbers):\n total = 0\n for num in numbers:\n total = total + num\n return total\n\nresult = calculate_sum([1, 2, 3, 4, 5])\nprint(result)\n```"
|
||||||
data?: string, // base64 for images
|
|
||||||
mimeType?: string
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
|
|
@ -97,57 +95,63 @@ To use a prompt, clients make a `prompts/get` request:
|
||||||
|
|
||||||
Prompts can be dynamic and include:
|
Prompts can be dynamic and include:
|
||||||
|
|
||||||
### Context integration
|
### Embedded resource context
|
||||||
|
|
||||||
```typescript
|
```json
|
||||||
const analyzeLogsPrompt = {
|
{
|
||||||
name: "analyze-logs",
|
"name": "analyze-project",
|
||||||
description: "Analyze recent system logs",
|
"description": "Analyze project logs and code",
|
||||||
arguments: [
|
"arguments": [
|
||||||
{
|
{
|
||||||
name: "timeframe",
|
"name": "timeframe",
|
||||||
description: "Time period to analyze",
|
"description": "Time period to analyze logs",
|
||||||
required: true
|
"required": true
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "fileUri",
|
||||||
|
"description": "URI of code file to review",
|
||||||
|
"required": true
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
};
|
}
|
||||||
|
|
||||||
server.setRequestHandler(GetPromptRequestSchema, async (request) => {
|
|
||||||
if (request.params.name === "analyze-logs") {
|
|
||||||
const logs = await getSystemLogs(request.params.arguments?.timeframe);
|
|
||||||
return {
|
|
||||||
messages: [
|
|
||||||
{
|
|
||||||
role: "user",
|
|
||||||
content: {
|
|
||||||
type: "text",
|
|
||||||
text: `Analyze these system logs and identify any issues:\n\n${logs}`
|
|
||||||
}
|
|
||||||
}
|
|
||||||
]
|
|
||||||
};
|
|
||||||
}
|
|
||||||
});
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Resource references
|
When handling the `prompts/get` request:
|
||||||
|
|
||||||
```typescript
|
```json
|
||||||
const codeReviewPrompt = {
|
{
|
||||||
name: "review-code",
|
"messages": [
|
||||||
async getMessages(fileUri: string) {
|
{
|
||||||
const code = await readResource(fileUri);
|
"role": "user",
|
||||||
return [
|
"content": {
|
||||||
{
|
"type": "text",
|
||||||
role: "user",
|
"text": "Analyze these system logs and the code file for any issues:"
|
||||||
content: {
|
}
|
||||||
type: "text",
|
},
|
||||||
text: `Review this code for best practices:\n\n${code}`
|
{
|
||||||
|
"role": "user",
|
||||||
|
"content": {
|
||||||
|
"type": "resource",
|
||||||
|
"resource": {
|
||||||
|
"uri": "logs://recent?timeframe=1h",
|
||||||
|
"text": "[2024-03-14 15:32:11] ERROR: Connection timeout in network.py:127\n[2024-03-14 15:32:15] WARN: Retrying connection (attempt 2/3)\n[2024-03-14 15:32:20] ERROR: Max retries exceeded",
|
||||||
|
"mimeType": "text/plain"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
];
|
},
|
||||||
}
|
{
|
||||||
};
|
"role": "user",
|
||||||
|
"content": {
|
||||||
|
"type": "resource",
|
||||||
|
"resource": {
|
||||||
|
"uri": "file:///path/to/code.py",
|
||||||
|
"text": "def connect_to_service(timeout=30):\n retries = 3\n for attempt in range(retries):\n try:\n return establish_connection(timeout)\n except TimeoutError:\n if attempt == retries - 1:\n raise\n time.sleep(5)\n\ndef establish_connection(timeout):\n # Connection implementation\n pass",
|
||||||
|
"mimeType": "text/x-python"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
### Multi-step workflows
|
### Multi-step workflows
|
||||||
|
|
@ -187,94 +191,107 @@ const debugWorkflow = {
|
||||||
|
|
||||||
Here's a complete example of implementing prompts in an MCP server:
|
Here's a complete example of implementing prompts in an MCP server:
|
||||||
|
|
||||||
```typescript
|
<Tabs>
|
||||||
import { Server } from "@modelcontextprotocol/sdk/server";
|
<Tab title="TypeScript">
|
||||||
import {
|
```typescript
|
||||||
ListPromptsRequestSchema,
|
import { Server } from "@modelcontextprotocol/sdk/server";
|
||||||
GetPromptRequestSchema
|
import {
|
||||||
} from "@modelcontextprotocol/sdk/types";
|
ListPromptsRequestSchema,
|
||||||
|
GetPromptRequestSchema
|
||||||
|
} from "@modelcontextprotocol/sdk/types";
|
||||||
|
|
||||||
const PROMPTS = {
|
const PROMPTS = {
|
||||||
"git-commit": {
|
"git-commit": {
|
||||||
name: "git-commit",
|
name: "git-commit",
|
||||||
description: "Generate a Git commit message",
|
description: "Generate a Git commit message",
|
||||||
arguments: [
|
arguments: [
|
||||||
{
|
{
|
||||||
name: "changes",
|
name: "changes",
|
||||||
description: "Git diff or description of changes",
|
description: "Git diff or description of changes",
|
||||||
required: true
|
required: true
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
},
|
|
||||||
"explain-code": {
|
|
||||||
name: "explain-code",
|
|
||||||
description: "Explain how code works",
|
|
||||||
arguments: [
|
|
||||||
{
|
|
||||||
name: "code",
|
|
||||||
description: "Code to explain",
|
|
||||||
required: true
|
|
||||||
},
|
},
|
||||||
{
|
"explain-code": {
|
||||||
name: "language",
|
name: "explain-code",
|
||||||
description: "Programming language",
|
description: "Explain how code works",
|
||||||
required: false
|
arguments: [
|
||||||
|
{
|
||||||
|
name: "code",
|
||||||
|
description: "Code to explain",
|
||||||
|
required: true
|
||||||
|
},
|
||||||
|
{
|
||||||
|
name: "language",
|
||||||
|
description: "Programming language",
|
||||||
|
required: false
|
||||||
|
}
|
||||||
|
]
|
||||||
}
|
}
|
||||||
]
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
const server = new Server({
|
|
||||||
name: "example-prompts-server",
|
|
||||||
version: "1.0.0"
|
|
||||||
});
|
|
||||||
|
|
||||||
// List available prompts
|
|
||||||
server.setRequestHandler(ListPromptsRequestSchema, async () => {
|
|
||||||
return {
|
|
||||||
prompts: Object.values(PROMPTS)
|
|
||||||
};
|
|
||||||
});
|
|
||||||
|
|
||||||
// Get specific prompt
|
|
||||||
server.setRequestHandler(GetPromptRequestSchema, async (request) => {
|
|
||||||
const prompt = PROMPTS[request.params.name];
|
|
||||||
if (!prompt) {
|
|
||||||
throw new Error(`Prompt not found: ${request.params.name}`);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (request.params.name === "git-commit") {
|
|
||||||
return {
|
|
||||||
messages: [
|
|
||||||
{
|
|
||||||
role: "user",
|
|
||||||
content: {
|
|
||||||
type: "text",
|
|
||||||
text: `Generate a concise but descriptive commit message for these changes:\n\n${request.params.arguments?.changes}`
|
|
||||||
}
|
|
||||||
}
|
|
||||||
]
|
|
||||||
};
|
};
|
||||||
}
|
|
||||||
|
|
||||||
if (request.params.name === "explain-code") {
|
const server = new Server({
|
||||||
const language = request.params.arguments?.language || "Unknown";
|
name: "example-prompts-server",
|
||||||
return {
|
version: "1.0.0"
|
||||||
messages: [
|
}, {
|
||||||
{
|
capabilities: {
|
||||||
role: "user",
|
prompts: {}
|
||||||
content: {
|
}
|
||||||
type: "text",
|
});
|
||||||
text: `Explain how this ${language} code works:\n\n${request.params.arguments?.code}`
|
|
||||||
}
|
// List available prompts
|
||||||
}
|
server.setRequestHandler(ListPromptsRequestSchema, async () => {
|
||||||
]
|
return {
|
||||||
};
|
prompts: Object.values(PROMPTS)
|
||||||
}
|
};
|
||||||
|
});
|
||||||
throw new Error("Prompt implementation not found");
|
|
||||||
});
|
// Get specific prompt
|
||||||
```
|
server.setRequestHandler(GetPromptRequestSchema, async (request) => {
|
||||||
|
const prompt = PROMPTS[request.params.name];
|
||||||
|
if (!prompt) {
|
||||||
|
throw new Error(`Prompt not found: ${request.params.name}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (request.params.name === "git-commit") {
|
||||||
|
return {
|
||||||
|
messages: [
|
||||||
|
{
|
||||||
|
role: "user",
|
||||||
|
content: {
|
||||||
|
type: "text",
|
||||||
|
text: `Generate a concise but descriptive commit message for these changes:\n\n${request.params.arguments?.changes}`
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
if (request.params.name === "explain-code") {
|
||||||
|
const language = request.params.arguments?.language || "Unknown";
|
||||||
|
return {
|
||||||
|
messages: [
|
||||||
|
{
|
||||||
|
role: "user",
|
||||||
|
content: {
|
||||||
|
type: "text",
|
||||||
|
text: `Explain how this ${language} code works:\n\n${request.params.arguments?.code}`
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
throw new Error("Prompt implementation not found");
|
||||||
|
});
|
||||||
|
```
|
||||||
|
</Tab>
|
||||||
|
<Tab title="Python">
|
||||||
|
```python
|
||||||
|
# Python implementation coming soon
|
||||||
|
```
|
||||||
|
</Tab>
|
||||||
|
</Tabs>
|
||||||
|
|
||||||
## Best practices
|
## Best practices
|
||||||
|
|
||||||
|
|
@ -324,70 +341,3 @@ When implementing prompts:
|
||||||
- Implement timeouts
|
- Implement timeouts
|
||||||
- Consider prompt injection risks
|
- Consider prompt injection risks
|
||||||
- Document security requirements
|
- Document security requirements
|
||||||
|
|
||||||
## Advanced features
|
|
||||||
|
|
||||||
### Prompt chaining
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
const analyzePRPrompt = {
|
|
||||||
async getMessages(prId: string) {
|
|
||||||
// Chain multiple prompts
|
|
||||||
const diffPrompt = await getPrompt("analyze-diff");
|
|
||||||
const testsPrompt = await getPrompt("review-tests");
|
|
||||||
const securityPrompt = await getPrompt("security-review");
|
|
||||||
|
|
||||||
return [
|
|
||||||
...diffPrompt.messages,
|
|
||||||
...testsPrompt.messages,
|
|
||||||
...securityPrompt.messages
|
|
||||||
];
|
|
||||||
}
|
|
||||||
};
|
|
||||||
```
|
|
||||||
|
|
||||||
### Context enrichment
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
const troubleshootPrompt = {
|
|
||||||
async getMessages(error: string) {
|
|
||||||
// Enrich with system context
|
|
||||||
const systemInfo = await getSystemInfo();
|
|
||||||
const recentLogs = await getRecentLogs();
|
|
||||||
const stackTrace = await parseError(error);
|
|
||||||
|
|
||||||
return [
|
|
||||||
{
|
|
||||||
role: "user",
|
|
||||||
content: {
|
|
||||||
type: "text",
|
|
||||||
text: `Help troubleshoot this error:
|
|
||||||
Error: ${error}
|
|
||||||
System: ${systemInfo}
|
|
||||||
Logs: ${recentLogs}
|
|
||||||
Stack: ${stackTrace}`
|
|
||||||
}
|
|
||||||
}
|
|
||||||
];
|
|
||||||
}
|
|
||||||
};
|
|
||||||
```
|
|
||||||
|
|
||||||
### Interactive workflows
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
const debugWorkflow = {
|
|
||||||
async getMessages(stage: string, context: any) {
|
|
||||||
switch (stage) {
|
|
||||||
case "initial":
|
|
||||||
return promptForError();
|
|
||||||
case "analysis":
|
|
||||||
return analyzeError(context.error);
|
|
||||||
case "solution":
|
|
||||||
return suggestFixes(context.analysis);
|
|
||||||
case "verification":
|
|
||||||
return verifyFix(context.solution);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
};
|
|
||||||
```
|
|
||||||
Loading…
Reference in a new issue