fix!: remove MCP server implementation

[ryoppippi]

Summary

Remove the standalone MCP server feature to align with the Node.js SDK which only provides MCP client functionality.

What Changed

• Removed stackone_ai/server.py - MCP server implementation
• Removed examples/mcp_server.py - MCP server example
• Removed stackmcp CLI entry point from pyproject.toml
• Updated CLAUDE.md - Removed MCP server documentation
• Updated README.md - Updated Python requirements note

Why

The Node.js SDK (stackone-ai-node) does not have an MCP server feature - it only provides MCP client functionality for fetching tools. This change aligns the Python SDK with the Node SDK's feature set.

What is retained:

• The MCP client functionality for fetch_tools() remains intact
• The mcp optional dependency is still available for the client
• All existing tests pass (85 tests)

Breaking Change

Users who were running stackmcp as an MCP server will need to use alternative approaches for MCP server functionality.

---

Summary by cubic

Remove the standalone MCP server and stackmcp CLI to align the Python SDK with the Node.js SDK, which only supports the MCP client. MCP client functionality (fetch_tools) remains.

• Refactors

  • Removed stackone_ai/server.py and examples/mcp_server.py.
  • Removed stackmcp CLI entry from pyproject.toml and the mcp-inspector task from justfile.
  • Updated mcp optional dependency to mcp>=1.3.0 (dropped [cli]).
  • Updated docs to remove MCP server references and clarify Python 3.9+ support (3.10+ for MCP-backed fetch_tools).

• Migration

  • The stackmcp CLI is removed; use an external MCP server if needed.
  • Continue using fetch_tools for the MCP client; keep the mcp extra installed if you rely on it.
  • No changes required if you only use the client API.

^{Written for commit 8d69043. Summary will update automatically on new commits.}

[cubic-dev-ai]

No issues found across 5 files

[Copilot]

Pull request overview

This PR removes the standalone MCP server functionality from the Python SDK to align with the Node.js SDK, which only provides MCP client capabilities. This is a breaking change for users who were using the stackmcp CLI command.

Key changes:

• Removed the entire MCP server implementation (241 lines)
• Removed the stackmcp CLI entry point
• Updated documentation to reflect that only MCP client functionality (fetch_tools()) is retained

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
stackone_ai/server.py	Complete removal of MCP server implementation including async tool execution and CLI interface
examples/mcp_server.py	Removed example documentation for running the MCP server
pyproject.toml	Removed stackmcp CLI entry point from project scripts
README.md	Updated Python version requirements to clarify MCP-backed fetch_tools() needs Python 3.10+
CLAUDE.md	Removed MCP server development commands and architecture documentation

The changes are clean and well-documented. All file deletions are complete, and the documentation updates accurately reflect the removal of the server functionality while making it clear that the MCP client functionality for fetch_tools() remains available.

Note: While reviewing, I noticed that some related files outside this PR (such as examples/test_examples.py which still references mcp_server.py, and justfile which still has an mcp-inspector target using stackmcp) may need to be updated in a follow-up change to maintain consistency across the codebase.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[glebedel]

LGTM