Commit Graph
3 Commits
Author SHA1 Message Date
Burak Kaygusuz 3fb8ae0f2c docs(python-mcp): update skill, instructions, agent, and plugin for MCP Python SDK v2 🤖🤖🤖 (#4737)
* docs(python-mcp-server-generator): rewrite skill for MCP Python SDK v2

- Target MCP Python SDK v2 (MCPServer) and MCP specification 2026-07-28
- Replace FastMCP imports with `from mcp.server import MCPServer`
- Rewrite the description with explicit triggers and exclusions
- Add the compatibility field (uv, Python 3.10+, npx for the Inspector)
- Add a five-step workflow checklist: create, write, test, validate, configure
- Pin the SDK with `uv add "mcp[cli]>=2,<3"` and use a flat uv app layout
- Add server and in-memory Client test templates
- Add a test-fix-retest validation loop with `uv run pytest`
- Add a Gotchas section for SDK v1 to v2 changes and deprecated features
- Move Streamable HTTP guidance to references/streamable-http.md
- Remove generic guidance that the model already knows

* docs(python-mcp-server): update instructions for MCP Python SDK v2

- Target MCP Python SDK v2 (MCPServer) and MCP specification 2026-07-28
- Replace FastMCP imports with MCPServer and mcp.server.mcpserver imports
- Move transport options from the constructor to run() and streamable_http_app()
- Use Resolve and Elicit for user input instead of ctx.elicit()
- Use ctx.notify_tools_changed() for list change notifications
- Explain ToolError and MCPError behavior for tool failures
- Mark sampling, protocol logging, and roots as deprecated
- Add transport security, CORS, and multi-worker guidance
- Add an in-memory Client test pattern
- Rewrite the text in ASD-STE100 Simplified Technical English
- Use single-quoted frontmatter values

* docs(python-mcp-expert): update agent for MCP Python SDK v2

- Target MCP Python SDK v2 (MCPServer) and MCP specification 2026-07-28
- Replace the retired GPT-4.1 model with GPT-6 Sol
- Replace FastMCP guidance with MCPServer guidance
- Add guidance for transport options, Resolve and Elicit, and notify_tools_changed()
- Explain ToolError and MCPError behavior for tool failures
- Mark sampling, protocol logging, and roots as deprecated
- Add SDK v1 to v2 migration as a supported scenario
- Rewrite the text in ASD-STE100 Simplified Technical English
- Use single-quoted frontmatter values

* chore(python-mcp-development): update plugin metadata for MCP Python SDK v2

- Remove FastMCP from the plugin description and README
- Describe the actual plugin contents: one skill and one agent
- Replace the fastmcp keyword with mcp-python-sdk
- Bump the plugin version to 2.0.0
- Regenerate marketplace.json and docs/README.plugins.md

* fix(python-mcp-server-generator): correct transport security, lifespan, and SSE notes

* fix(python-mcp-server): remove invalid structured_output advice and align with skill

* fix(python-mcp-expert): add missing SDK v2 rules and remove repeated guidance

* fix(python-mcp-expert): remove the retired model from frontmatter

* fix(python-mcp-server-generator): state Node.js as the MCP Inspector prerequisite
2026-10-09 12:00:23 +11:00
Aaron Powell 647889c0ac refresh readme 2026-02-05 13:56:13 +11:00
Aaron Powell 003a01cc7e Add plugins for all collections
Generate plugin directories for 36 collections not previously represented:
- awesome-copilot, cast-imaging, clojure-interactive-programming, copilot-sdk
- csharp-dotnet-development, csharp-mcp-development, database-data-management
- dataverse-sdk-for-python, devops-oncall, edge-ai-tasks, frontend-web-dev
- go-mcp-development, java-development, java-mcp-development, kotlin-mcp-development
- mcp-m365-copilot, openapi-to-application-* (5 variants), partners
- pcf-development, php-mcp-development, power-apps-code-apps, power-bi-development
- power-platform-mcp-connector-development, python-mcp-development
- ruby-mcp-development, rust-mcp-development, security-best-practices
- structured-autonomy, swift-mcp-development, technical-spike
- typescript-mcp-development, typespec-m365-copilot

Each plugin includes:
- .github/plugin/plugin.json with metadata
- README.md with installation instructions
- Symlinks to canonical agents, commands, and skills

Updated marketplace.json to include all 40 plugins.
2026-02-03 16:40:57 +11:00