Skip to content

Commit 5ad5a52

Browse files
Merge pull request modelcontextprotocol#1328 from jonathanhefner/fix-build
Fix CI
2 parents 97d0178 + d1935d2 commit 5ad5a52

File tree

47 files changed

+12
-118
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

47 files changed

+12
-118
lines changed

docs/docs/learn/architecture.mdx

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -372,7 +372,6 @@ The request structure includes several important components:
372372
1. **`name`**: Must match exactly the tool name from the discovery response (`weather_current`). This ensures the server can correctly identify which tool to execute.
373373

374374
2. **`arguments`**: Contains the input parameters as defined by the tool's `inputSchema`. In this example:
375-
376375
- `location`: "San Francisco" (required parameter)
377376
- `units`: "imperial" (optional parameter, defaults to "metric" if not specified)
378377

docs/docs/learn/server-concepts.mdx

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -225,7 +225,6 @@ Consider an AI application with three connected servers:
225225
```
226226

227227
2. **User selects resources to include:**
228-
229228
- `calendar://my-calendar/June-2024` (from Calendar Server)
230229
- `travel://preferences/europe` (from Travel Server)
231230
- `travel://past-trips/Spain-2023` (from Travel Server)

docs/legacy/concepts/architecture.mdx

Lines changed: 0 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,6 @@ Key classes include:
105105
The transport layer handles the actual communication between clients and servers. MCP supports multiple transport mechanisms:
106106

107107
1. **Stdio transport**
108-
109108
- Uses standard input/output for communication
110109
- Ideal for local processes
111110

@@ -288,7 +287,6 @@ if __name__ == "__main__":
288287
### Transport selection
289288

290289
1. **Local communication**
291-
292290
- Use stdio transport for local processes
293291
- Efficient for same-machine communication
294292
- Simple process management
@@ -300,14 +298,12 @@ if __name__ == "__main__":
300298
### Message handling
301299

302300
1. **Request processing**
303-
304301
- Validate inputs thoroughly
305302
- Use type-safe schemas
306303
- Handle errors gracefully
307304
- Implement timeouts
308305

309306
2. **Progress reporting**
310-
311307
- Use progress tokens for long operations
312308
- Report progress incrementally
313309
- Include total progress when known
@@ -320,20 +316,17 @@ if __name__ == "__main__":
320316
## Security considerations
321317

322318
1. **Transport security**
323-
324319
- Use TLS for remote connections
325320
- Validate connection origins
326321
- Implement authentication when needed
327322

328323
2. **Message validation**
329-
330324
- Validate all incoming messages
331325
- Sanitize inputs
332326
- Check message size limits
333327
- Verify JSON-RPC format
334328

335329
3. **Resource protection**
336-
337330
- Implement access controls
338331
- Validate resource paths
339332
- Monitor resource usage
@@ -348,14 +341,12 @@ if __name__ == "__main__":
348341
## Debugging and monitoring
349342

350343
1. **Logging**
351-
352344
- Log protocol events
353345
- Track message flow
354346
- Monitor performance
355347
- Record errors
356348

357349
2. **Diagnostics**
358-
359350
- Implement health checks
360351
- Monitor connection state
361352
- Track resource usage

docs/legacy/concepts/sampling.mdx

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,6 @@ The `messages` array contains the conversation history to send to the LLM. Each
7777
The `modelPreferences` object allows servers to specify their model selection preferences:
7878

7979
- `hints`: Array of model name suggestions that clients can use to select an appropriate model:
80-
8180
- `name`: String that can match full or partial model names (e.g. "claude-3", "sonnet")
8281
- Clients may map hints to equivalent models from different providers
8382
- Multiple hints are evaluated in preference order

docs/legacy/tools/debugging.mdx

Lines changed: 0 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -16,13 +16,11 @@ This guide is for macOS. Guides for other platforms are coming soon.
1616
MCP provides several tools for debugging at different levels:
1717

1818
1. **MCP Inspector**
19-
2019
- Interactive debugging interface
2120
- Direct server testing
2221
- See the [Inspector guide](/legacy/tools/inspector) for details
2322

2423
2. **Claude Desktop Developer Tools**
25-
2624
- Integration testing
2725
- Log collection
2826
- Chrome DevTools integration
@@ -39,7 +37,6 @@ MCP provides several tools for debugging at different levels:
3937
The Claude.app interface provides basic server status information:
4038

4139
1. Click the <img src="/images/claude-desktop-mcp-plug-icon.svg" style={{display: 'inline', margin: 0, height: '1.3em'}} /> icon to view:
42-
4340
- Connected servers
4441
- Available prompts and resources
4542

@@ -133,14 +130,12 @@ To override the default variables or provide your own, you can specify an `env`
133130
Common initialization problems:
134131

135132
1. **Path Issues**
136-
137133
- Incorrect server executable path
138134
- Missing required files
139135
- Permission problems
140136
- Try using an absolute path for `command`
141137

142138
2. **Configuration Errors**
143-
144139
- Invalid JSON syntax
145140
- Missing required fields
146141
- Type mismatches
@@ -213,7 +208,6 @@ In client applications:
213208
### Development cycle
214209

215210
1. Initial Development
216-
217211
- Use [Inspector](/legacy/tools/inspector) for basic testing
218212
- Implement core functionality
219213
- Add logging points
@@ -236,14 +230,12 @@ To test changes efficiently:
236230
### Logging strategy
237231

238232
1. **Structured Logging**
239-
240233
- Use consistent formats
241234
- Include context
242235
- Add timestamps
243236
- Track request IDs
244237

245238
2. **Error Handling**
246-
247239
- Log stack traces
248240
- Include error context
249241
- Track error patterns
@@ -260,7 +252,6 @@ To test changes efficiently:
260252
When debugging:
261253

262254
1. **Sensitive Data**
263-
264255
- Sanitize logs
265256
- Protect credentials
266257
- Mask personal information
@@ -275,14 +266,12 @@ When debugging:
275266
When encountering issues:
276267

277268
1. **First Steps**
278-
279269
- Check server logs
280270
- Test with [Inspector](/legacy/tools/inspector)
281271
- Review configuration
282272
- Verify environment
283273

284274
2. **Support Channels**
285-
286275
- GitHub issues
287276
- GitHub discussions
288277

docs/legacy/tools/inspector.mdx

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -119,13 +119,11 @@ The Inspector provides several features for interacting with your MCP server:
119119
### Development workflow
120120

121121
1. Start Development
122-
123122
- Launch Inspector with your server
124123
- Verify basic connectivity
125124
- Check capability negotiation
126125

127126
2. Iterative testing
128-
129127
- Make server changes
130128
- Rebuild the server
131129
- Reconnect the Inspector

docs/quickstart/client.mdx

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -305,13 +305,11 @@ You can find the complete `client.py` file [here.](https://gist.github.com/zckly
305305
## Common Customization Points
306306

307307
1. **Tool Handling**
308-
309308
- Modify `process_query()` to handle specific tool types
310309
- Add custom error handling for tool calls
311310
- Implement tool-specific response formatting
312311

313312
2. **Response Processing**
314-
315313
- Customize how tool results are formatted
316314
- Add response filtering or transformation
317315
- Implement custom logging
@@ -366,13 +364,11 @@ When you submit a query:
366364
## Best practices
367365

368366
1. **Error Handling**
369-
370367
- Always wrap tool calls in try-catch blocks
371368
- Provide meaningful error messages
372369
- Gracefully handle connection issues
373370

374371
2. **Resource Management**
375-
376372
- Use `AsyncExitStack` for proper cleanup
377373
- Close connections when done
378374
- Handle server disconnections
@@ -776,7 +772,6 @@ When you submit a query:
776772
## Best practices
777773

778774
1. **Error Handling**
779-
780775
- Use TypeScript's type system for better error detection
781776
- Wrap tool calls in try-catch blocks
782777
- Provide meaningful error messages
@@ -1390,7 +1385,6 @@ When you submit a query:
13901385
## Best practices
13911386

13921387
1. **Error Handling**
1393-
13941388
- Leverage Kotlin's type system to model errors explicitly
13951389
- Wrap external tool and API calls in `try-catch` blocks when exceptions are possible
13961390
- Provide clear and meaningful error messages

docs/specification/2024-11-05/architecture/index.mdx

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -83,22 +83,19 @@ MCP is built on several key design principles that inform its architecture and
8383
implementation:
8484

8585
1. **Servers should be extremely easy to build**
86-
8786
- Host applications handle complex orchestration responsibilities
8887
- Servers focus on specific, well-defined capabilities
8988
- Simple interfaces minimize implementation overhead
9089
- Clear separation enables maintainable code
9190

9291
2. **Servers should be highly composable**
93-
9492
- Each server provides focused functionality in isolation
9593
- Multiple servers can be combined seamlessly
9694
- Shared protocol enables interoperability
9795
- Modular design supports extensibility
9896

9997
3. **Servers should not be able to read the whole conversation, nor "see into" other
10098
servers**
101-
10299
- Servers receive only necessary contextual information
103100
- Full conversation history stays with the host
104101
- Each server connection maintains isolation

docs/specification/2024-11-05/basic/utilities/progress.mdx

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,6 @@ The receiver **MAY** then send progress notifications containing:
5656
## Behavior Requirements
5757

5858
1. Progress notifications **MUST** only reference tokens that:
59-
6059
- Were provided in an active request
6160
- Are associated with an in-progress operation
6261

docs/specification/2024-11-05/client/roots.mdx

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -165,7 +165,6 @@ Example error:
165165
## Security Considerations
166166

167167
1. Clients **MUST**:
168-
169168
- Only expose roots with appropriate permissions
170169
- Validate all root URIs to prevent path traversal
171170
- Implement proper access controls
@@ -179,7 +178,6 @@ Example error:
179178
## Implementation Guidelines
180179

181180
1. Clients **SHOULD**:
182-
183181
- Prompt users for consent before exposing roots to servers
184182
- Provide clear user interfaces for root management
185183
- Validate root accessibility before exposing

0 commit comments

Comments
 (0)