mirror of
https://github.com/mcp-use/mcp-use.git
synced 2026-09-14 18:06:01 +08:00
Luigi Pederzani
6b2db4a2b0
Reshape docs, examples, and indexes to mirror the README narrative:
MCP Servers + MCP Apps are primary; MCP Agent and MCP Client are
present but secondary. Remove duplicated concepts, deprecated pages,
and stale examples; add redirects for removed paths.
Docs
- Rewrite home/index.mdx: tagline + MCP Server / MCP App split cards,
quickstart tabs, MCP Apps widget snippet, Templates teaser, Inspector,
Deploy, Agent+Client in a collapsed accordion.
- New home/templates.mdx gallery (Chart Builder, Diagram Builder, Slide
Deck, Maps Explorer, Widget Gallery, and more) with demo URLs and
deploy buttons, mirroring the README.
- Simplify python/typescript welcome.mdx: drop duplicated "What is MCP?"
/ "Why mcp-use?" (single pointer to home/mcp101); server-first Next
Steps; fix broken Python links.
- docs.json: Home product reshaped (Welcome, MCP Apps, Templates, Dev
Tools + CLI reference, Concepts, Libraries, Misc). Python
Integrations collapsed into MCP Agents → LLM Adapters.
fastapi_mount added to Python MCP Server Overview. TS MCP Apps adds
creating-mcp-apps-server; OAuth Providers gets keycloak + custom.
Empty API Reference, misrouted Community, and Blog tabs removed from
TS SDK.
- Delete: ui-widgets.mdx, mcp-ui-resources.mdx,
comparison-with-other-implementations.mdx, api-reference.mdx (empty),
typescript/development/security.mdx, python/blog/middleware.mdx,
python/server/auth/index.mdx.
- Redirects: old paths → current equivalents.
- CLI reference: new "What's New" card group (HMR, --tunnel, skills
add, generate-types); cross-link from `start` to Tunneling guide.
Examples
- Rewrite libraries/typescript/.../examples/server/ui/mcp-ui/ as a
programmatic MCP Apps widget gallery (welcome-card, quick-poll,
task-card) using server.uiResource({ type: "mcpApps", htmlTemplate }).
Removes deprecated UIResource / rawHtml / remoteDom patterns.
- Delete empty server/ui/apps-sdk/.
- Fix stale docs URL in server/ui/mcp-apps/apps-sdk/index.ts.
- Update examples/README.md and TS examples README: add Templates
pointer (github.com/mcp-use/mcp-use#templates + docs/home/templates),
list previously-missing examples (mcp-apps, files, model-context,
middleware, session-management, better-auth, Python orphans), flag
apps-sdk as legacy.
96 lines
4.4 KiB
Plaintext
96 lines
4.4 KiB
Plaintext
---
|
|
title: "Version 1.3.12"
|
|
description: "Middleware introduction and documentation updates"
|
|
icon: "layers"
|
|
og:image: "https://mcp-use.com/api/og/release?v=1.3.12"
|
|
---
|
|
|
|
import { Contributors } from '/snippets/contributors.jsx'
|
|
|
|
<Card img="https://mcp-use.com/api/og/release?v=1.3.12" title="Release 1.3.12" href="https://github.com/mcp-use/mcp-use/releases/tag/1.3.12">
|
|
This release focuses on middleware introduction and comprehensive documentation improvements. The most significant additions include a new middleware system and automatic API documentation generation.
|
|
</Card>
|
|
|
|
## New Features
|
|
|
|
### Middleware System
|
|
**[PR #269](https://github.com/mcp-use/mcp-use/pull/269)**
|
|
|
|
Introduced a comprehensive middleware system that allows for request/response interception and processing. The middleware framework supports custom logic injection, metrics collection, and request transformation capabilities.
|
|
|
|
For a detailed technical deep-dive into the middleware architecture and design decisions, see the [Middleware Pipeline PR](https://github.com/mcp-use/mcp-use/pull/269).
|
|
|
|
### Automatic API Documentation
|
|
**[PR #301](https://github.com/mcp-use/mcp-use/pull/301)**
|
|
|
|
Implemented automatic API documentation generation to streamline the development workflow. This feature automatically generates comprehensive API references from code annotations and docstrings, ensuring documentation stays current with code changes.
|
|
|
|
## Bug Fixes & Improvements
|
|
|
|
### Tool Result Standardization
|
|
**[PR #288](https://github.com/mcp-use/mcp-use/pull/288)**
|
|
|
|
Fixed tool result formatting to ensure consistent output across different MCP servers and tools. The system now returns tool results in a standardized format, improving compatibility and predictability.
|
|
|
|
### Duplicate User Message Prevention
|
|
**[PR #287](https://github.com/mcp-use/mcp-use/pull/287)**
|
|
|
|
Resolved an issue where user messages were being duplicated in conversation history, particularly when memory features were enabled. The fix ensures clean conversation tracking and prevents redundant message storage.
|
|
|
|
### Agent Memory Enhancement
|
|
**[PR #187](https://github.com/mcp-use/mcp-use/pull/187)**
|
|
|
|
Improved agent memory handling to prevent duplicate user queries when memory is enabled. This enhancement ensures more efficient memory usage and cleaner conversation flow.
|
|
|
|
### Test Server Execution Fix
|
|
**[PR #298](https://github.com/mcp-use/mcp-use/pull/298)**
|
|
|
|
Fixed test server execution issues by properly using executable paths for shared dependencies. This improvement ensures reliable test execution across different environments.
|
|
|
|
## Maintenance & Documentation
|
|
|
|
### Middleware Metrics Enhancement
|
|
**[PR #299](https://github.com/mcp-use/mcp-use/pull/299)**
|
|
|
|
Enhanced middleware metrics collection for better performance and maintainability. The updated system provides more accurate metrics and improved observability for MCP operations.
|
|
|
|
### Documentation Enhancements
|
|
**[PRs #301](https://github.com/mcp-use/mcp-use/pull/301), [#282](https://github.com/mcp-use/mcp-use/pull/282)**
|
|
|
|
Comprehensive documentation updates including:
|
|
- Enhanced API reference generation
|
|
- Updated TypeScript integration examples
|
|
- Removed deprecated `from_dict` method references
|
|
- Improved developer onboarding materials
|
|
|
|
### Docker Networking Documentation
|
|
**[PR #286](https://github.com/mcp-use/mcp-use/pull/286)**
|
|
|
|
Added documentation addressing common Docker networking issues, helping developers troubleshoot containerized MCP server deployments.
|
|
|
|
### Limited Memory Example
|
|
**[Commit 6a807a1](https://github.com/mcp-use/mcp-use/commit/6a807a1)**
|
|
|
|
Added practical example demonstrating limited memory usage patterns for MCP agents, showcasing efficient memory management techniques.
|
|
|
|
## Automated Updates
|
|
|
|
### Dependency Management
|
|
**[PR #267](https://github.com/mcp-use/mcp-use/pull/267) by @github-actions[bot]**
|
|
|
|
Regular automated updates to dependent package information, ensuring compatibility with the latest ecosystem versions and maintaining security posture.
|
|
|
|
### Documentation Workflow Improvements
|
|
**[PRs #173](https://github.com/mcp-use/mcp-use/pull/173), [#301](https://github.com/mcp-use/mcp-use/pull/301)**
|
|
|
|
Enhanced documentation workflows with:
|
|
- Mintlify CLI integration for improved documentation generation
|
|
- Link checking to ensure documentation integrity
|
|
- Automated API reference updates
|
|
|
|
## Contributors
|
|
|
|
Thank you to all contributors who made this release possible:
|
|
|
|
<Contributors users="pietrozullo,renvins" />
|