xcode-mcp-server 1.3.11b4__tar.gz → 1.3.12__tar.gz

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xcode-mcp-server
-Version: 1.3.11b4
+Version: 1.3.12
 Summary: Drew's MCP server for Xcode integration
 Project-URL: Homepage, https://github.com/drewster99/xcode-mcp-server
 Project-URL: Repository, https://github.com/drewster99/xcode-mcp-server
@@ -17,7 +17,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.10
-Requires-Dist: mcp[cli]>=1.2.0
+Requires-Dist: mcp[cli]>=1.7.0
 Requires-Dist: questionary>=2.0.0
 Requires-Dist: rich>=13.0.0
 Description-Content-Type: text/markdown

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/pyproject.toml

@@ -23,7 +23,7 @@ classifiers = [
     "Programming Language :: Python :: 3.12",
 ]
 dependencies = [
-    "mcp[cli]>=1.2.0",
+    "mcp[cli]>=1.7.0",
     "questionary>=2.0.0",
     "rich>=13.0.0",
 ]

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/__init__.py

@@ -1,6 +1,6 @@
 """Xcode MCP Server - Model Context Protocol server for Xcode integration"""
 
-__version__ = "1.3.11b4"
+__version__ = "1.3.12"
 
 
 def main():

xcode_mcp_server-1.3.12/xcode_mcp_server/server.py

@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+"""FastMCP server instance for Xcode MCP Server"""
+
+from mcp.server.fastmcp import FastMCP
+from mcp.types import ToolAnnotations
+
+# Initialize the MCP server
+mcp = FastMCP("Xcode MCP Server",
+    instructions="""
+        This server provides access to the Xcode IDE. For any project intended
+        for Apple platforms, such as iOS or macOS, this MCP server is the best
+        way to build or run .xcodeproj or .xcworkspace Xcode projects, and should
+        ALWAYS be preferred over using `xcodebuild`, `swift build`, or
+        `swift package build`. Building with this tool ensures the build happens
+        exactly the same way as when the user builds with Xcode, with all the same
+        settings, so you will get the same results the user sees. The user can also
+        see any results immediately and a subsequent build and run by the user will
+        happen almost instantly for the user.
+
+        Call `get_xcode_projects` to find Xcode project (.xcodeproj) and
+        Xcode workspace (.xcworkspace) folders under a given root folder.
+
+        Call `get_project_schemes` to get the build scheme names for a given
+        .xcodeproj or .xcworkspace.
+
+        Call `build_project` to build the project and get back the first 25 lines of
+        error (and/or potentially warning) output. `build_project` will default to the
+        active scheme if none is provided.
+    """
+)
+
+# Tool behavior annotations (advisory hints for MCP clients).
+#
+# These describe how a tool affects its environment so clients can gate
+# auto-approval and label tools appropriately. The build/run/test tools are
+# marked destructive AND open-world: a build executes arbitrary third-party
+# code (Run Script phases, SPM plugins/macros) and resolves packages from
+# arbitrary remote hosts, so we cannot honestly claim it is additive-only,
+# idempotent, or hermetic.
+
+# Pure observers: reading state, listing, screenshots. No mutation, no network.
+TOOL_READONLY = ToolAnnotations(
+    readOnlyHint=True,
+    idempotentHint=True,
+    destructiveHint=False,
+    openWorldHint=False,
+)
+
+# Builds and runs: execute arbitrary build/install scripts and fetch packages.
+TOOL_BUILD = ToolAnnotations(
+    readOnlyHint=False,
+    idempotentHint=False,
+    destructiveHint=True,
+    openWorldHint=True,
+)
+
+# Clean: deletes build artifacts. Destructive but locally bounded and idempotent.
+TOOL_CLEAN = ToolAnnotations(
+    readOnlyHint=False,
+    idempotentHint=True,
+    destructiveHint=True,
+    openWorldHint=False,
+)
+
+# Create: writes a fresh template and refuses to overwrite. Additive, local.
+TOOL_CREATE = ToolAnnotations(
+    readOnlyHint=False,
+    idempotentHint=False,
+    destructiveHint=False,
+    openWorldHint=False,
+)
+
+# Settles a piece of local state (run destination, stopping a run). Re-applying
+# the same call lands on the same state, and nothing is destroyed.
+TOOL_MUTATING_IDEMPOTENT = ToolAnnotations(
+    readOnlyHint=False,
+    idempotentHint=True,
+    destructiveHint=False,
+    openWorldHint=False,
+)

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/build_project.py

@@ -8,7 +8,7 @@ import sys
 import time
 from typing import Optional
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_BUILD
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_and_normalize_project_path
 from xcode_mcp_server.exceptions import InvalidParameterError, XCodeMCPError
@@ -283,7 +283,7 @@ def _supplement_with_xcactivitylog_warnings(
         return errors_json
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_BUILD)
 @apply_config
 def build_project(project_path: str,
                  scheme: Optional[str] = None,

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/clean_project.py

@@ -3,7 +3,7 @@
 
 import os
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_CLEAN
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_and_normalize_project_path
 from xcode_mcp_server.exceptions import XCodeMCPError
@@ -17,7 +17,7 @@ from xcode_mcp_server.utils.applescript import (
 )
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_CLEAN)
 @apply_config
 def clean_project(project_path: str) -> str:
     """

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/create_project.py

@@ -5,7 +5,7 @@ import json
 import os
 from typing import Optional
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_CREATE
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_parent_for_new_project
 from xcode_mcp_server.exceptions import InvalidParameterError
@@ -23,7 +23,7 @@ from xcode_mcp_server.tools.get_xcode_projects import register_created_project
 SUPPORTED_PLATFORMS = {"ios", "macos"}
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_CREATE)
 @apply_config
 def create_project(
     parent_directory: str,

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/debug_list_notification_history.py

@@ -5,7 +5,7 @@ import os
 import subprocess
 import sys
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.utils.applescript import get_notification_history
 from xcode_mcp_server.utils.paths import DEBUG_DIR
@@ -16,7 +16,7 @@ from xcode_mcp_server.utils.paths import DEBUG_DIR
 NOTIFICATION_HISTORY_FILE = os.path.join(DEBUG_DIR, "notification-history.txt")
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def debug_list_notification_history() -> str:
     """

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/get_active_run_destination.py

@@ -7,7 +7,7 @@ import os
 import subprocess
 import sys
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_and_normalize_project_path
 from xcode_mcp_server.exceptions import XCodeMCPError
@@ -162,7 +162,7 @@ def _lookup_simulator_info(udid: str) -> tuple:
     return ("", "")
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def get_active_run_destination(
     project_path: str,

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/get_build_errors.py

@@ -3,7 +3,7 @@
 
 from typing import Optional
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_and_normalize_project_path
 from xcode_mcp_server.exceptions import InvalidParameterError, XCodeMCPError
@@ -11,7 +11,7 @@ from xcode_mcp_server.utils.applescript import escape_applescript_string, run_ap
 from xcode_mcp_server.utils.xcresult import extract_build_errors_and_warnings
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def get_build_errors(project_path: str,
                     include_warnings: Optional[bool] = None,

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/get_build_results.py

@@ -5,7 +5,7 @@ import os
 import json
 from typing import Optional
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_and_normalize_project_path
 from xcode_mcp_server.exceptions import XCodeMCPError
@@ -15,7 +15,7 @@ from xcode_mcp_server.utils.build_log_parser import (
 )
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def get_build_results(project_path: str,
                      max_warnings: int = 50) -> str:

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/get_directory_listing.py

@@ -6,14 +6,14 @@ import re
 import datetime
 from typing import Optional
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_and_normalize_directory_path
 from xcode_mcp_server.exceptions import AccessDeniedError, InvalidParameterError, XCodeMCPError
 from xcode_mcp_server.utils.applescript import show_error_notification
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def get_directory_listing(directory_path: str,
                          regex_filter: Optional[str] = None,

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/get_directory_tree.py

@@ -4,7 +4,7 @@
 import os
 from typing import List
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_and_normalize_directory_path
 from xcode_mcp_server.exceptions import InvalidParameterError, XCodeMCPError
@@ -32,7 +32,7 @@ SKIP_DIR_NAMES = frozenset([
 MAX_TREE_LINES = 5000
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def get_directory_tree(directory_path: str, max_depth: int = 4) -> str:
     """

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/get_latest_test_results.py

@@ -5,7 +5,7 @@ import os
 import json
 import sys
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_and_normalize_project_path
 from xcode_mcp_server.utils.applescript import (
@@ -18,7 +18,7 @@ from xcode_mcp_server.utils.applescript import (
 from xcode_mcp_server.utils.xcresult import find_xcresult_bundle, extract_test_results_from_xcresult
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def get_latest_test_results(project_path: str) -> str:
     """

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/get_project_schemes.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """get_project_schemes tool - Get available build schemes"""
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_and_normalize_project_path
 from xcode_mcp_server.exceptions import XCodeMCPError
@@ -14,7 +14,7 @@ from xcode_mcp_server.utils.applescript import (
 )
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def get_project_schemes(project_path: str) -> str:
     """

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/get_runtime_output.py

@@ -5,7 +5,7 @@ import sys
 import json
 from typing import Optional
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_and_normalize_project_path
 from xcode_mcp_server.exceptions import InvalidParameterError, XCodeMCPError
@@ -13,7 +13,7 @@ from xcode_mcp_server.utils.xcresult import find_xcresult_for_project, extract_c
 from xcode_mcp_server.utils.applescript import show_error_notification, show_warning_notification, show_result_notification
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def get_runtime_output(project_path: str,
                       regex_filter: Optional[str] = None,

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/get_xcode_projects.py

@@ -6,7 +6,7 @@ import sys
 import subprocess
 import re
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import ALLOWED_FOLDERS, is_path_allowed
 from xcode_mcp_server.exceptions import AccessDeniedError, InvalidParameterError
@@ -179,7 +179,7 @@ def _filter_project_results(paths: list[str], search_paths: list[str] = None, ma
     return final_results
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def get_xcode_projects(
     search_path: str = "",

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/list_booted_simulators.py

@@ -3,14 +3,14 @@
 
 import subprocess
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.exceptions import XCodeMCPError
 from xcode_mcp_server.utils.applescript import show_result_notification, show_error_notification
 from xcode_mcp_server.utils.screenshot import _get_booted_simulators
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def list_booted_simulators() -> str:
     """

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/list_mac_app_windows.py

@@ -5,13 +5,13 @@ import os
 import tempfile
 import subprocess
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.exceptions import XCodeMCPError
 from xcode_mcp_server.utils.applescript import show_result_notification, show_error_notification
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def list_mac_app_windows() -> str:
     """

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/list_project_tests.py

@@ -6,14 +6,14 @@ import re
 import subprocess
 import sys
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.exceptions import XCodeMCPError
 from xcode_mcp_server.security import validate_and_normalize_project_path
 from xcode_mcp_server.utils.applescript import show_result_notification, show_error_notification
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def list_project_tests(project_path: str) -> str:
     """

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/list_run_destinations.py

@@ -8,7 +8,7 @@ import subprocess
 import sys
 from typing import Optional
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_and_normalize_project_path
 from xcode_mcp_server.exceptions import XCodeMCPError
@@ -73,7 +73,7 @@ def _parse_destination_line(line: str) -> Optional[dict]:
     return result
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def list_run_destinations(
     project_path: str,

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/list_running_mac_apps.py

@@ -1,13 +1,13 @@
 #!/usr/bin/env python3
 """list_running_mac_apps tool - List running macOS applications"""
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.exceptions import XCodeMCPError
 from xcode_mcp_server.utils.applescript import show_notification, run_applescript, show_result_notification, show_error_notification
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def list_running_mac_apps() -> str:
     """

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/run_project_tests.py

@@ -7,7 +7,7 @@ import time
 import json
 from typing import Optional, List
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_BUILD
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_and_normalize_project_path
 from xcode_mcp_server.exceptions import InvalidParameterError
@@ -149,7 +149,7 @@ from xcode_mcp_server.utils.xcresult import find_xcresult_bundle, extract_test_r
 #         return f"⏳ Tests did not complete within {max_wait_seconds} seconds"
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_BUILD)
 @apply_config
 def run_project_tests(project_path: str,
                      scheme: Optional[str] = None) -> str:

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/run_project_unmonitored.py

@@ -4,7 +4,7 @@
 import os
 from typing import Optional
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_BUILD
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_and_normalize_project_path
 from xcode_mcp_server.exceptions import XCodeMCPError
@@ -17,7 +17,7 @@ from xcode_mcp_server.utils.applescript import (
 )
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_BUILD)
 @apply_config
 def run_project_unmonitored(project_path: str,
                              scheme: Optional[str] = None) -> str:

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/run_project_until_terminated.py

@@ -7,7 +7,7 @@ import time
 import datetime
 from typing import Optional
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_BUILD
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_and_normalize_project_path
 from xcode_mcp_server.exceptions import XCodeMCPError
@@ -27,7 +27,7 @@ from xcode_mcp_server.utils.xcresult import (
 )
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_BUILD)
 @apply_config
 def run_project_until_terminated(project_path: str,
                                   scheme: Optional[str] = None,

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/run_project_with_user_interaction.py

@@ -7,7 +7,7 @@ import time
 import datetime
 from typing import Optional
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_BUILD
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_and_normalize_project_path
 from xcode_mcp_server.exceptions import XCodeMCPError
@@ -36,7 +36,7 @@ MAX_INTERACTIVE_RUN_SECONDS = 3600
 LAUNCH_SETTLE_TIMEOUT = 10
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_BUILD)
 @apply_config
 def run_project_with_user_interaction(project_path: str,
                                        scheme: Optional[str] = None,

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/set_run_destination.py

@@ -4,7 +4,7 @@
 import json
 import os
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_MUTATING_IDEMPOTENT
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_and_normalize_project_path
 from xcode_mcp_server.exceptions import InvalidParameterError, XCodeMCPError
@@ -18,7 +18,7 @@ from xcode_mcp_server.utils.applescript import (
 )
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_MUTATING_IDEMPOTENT)
 @apply_config
 def set_run_destination(
     project_path: str,

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/stop_project.py

@@ -3,14 +3,14 @@
 
 import os
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_MUTATING_IDEMPOTENT
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_and_normalize_project_path
 from xcode_mcp_server.exceptions import InvalidParameterError, XCodeMCPError
 from xcode_mcp_server.utils.applescript import escape_applescript_string, run_applescript, show_result_notification, show_error_notification
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_MUTATING_IDEMPOTENT)
 @apply_config
 def stop_project(project_path: str) -> str:
     """

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/take_app_screenshot.py

@@ -4,14 +4,14 @@
 import os
 import subprocess
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.exceptions import XCodeMCPError
 from xcode_mcp_server.utils.applescript import show_result_notification, show_error_notification
 from xcode_mcp_server.utils.screenshot import _get_all_windows, get_screenshot_path
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def take_app_screenshot(app_name: str) -> str:
     """

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/take_simulator_screenshot.py

@@ -6,14 +6,14 @@ import sys
 import subprocess
 from typing import Optional
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.exceptions import XCodeMCPError
 from xcode_mcp_server.utils.applescript import show_result_notification, show_error_notification
 from xcode_mcp_server.utils.screenshot import _get_booted_simulators, get_screenshot_path
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def take_simulator_screenshot(udid: Optional[str] = None) -> str:
     """

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/take_window_screenshot.py

@@ -4,14 +4,14 @@
 import os
 import subprocess
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.exceptions import XCodeMCPError
 from xcode_mcp_server.utils.applescript import show_result_notification, show_error_notification
 from xcode_mcp_server.utils.screenshot import _get_all_windows, get_screenshot_path
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def take_window_screenshot(window_id_or_name: str) -> str:
     """

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/take_xcode_screenshot.py

@@ -5,7 +5,7 @@ import os
 import sys
 import subprocess
 
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.security import validate_and_normalize_project_path
 from xcode_mcp_server.exceptions import XCodeMCPError
@@ -18,7 +18,7 @@ from xcode_mcp_server.utils.applescript import (
 from xcode_mcp_server.utils.screenshot import get_screenshot_path
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def take_xcode_screenshot(project_path: str) -> str:
     """

{xcode_mcp_server-1.3.11b4 → xcode_mcp_server-1.3.12}/xcode_mcp_server/tools/version.py

@@ -2,12 +2,12 @@
 """version tool - Get server version"""
 
 from xcode_mcp_server import __version__
-from xcode_mcp_server.server import mcp
+from xcode_mcp_server.server import mcp, TOOL_READONLY
 from xcode_mcp_server.config_manager import apply_config
 from xcode_mcp_server.utils.applescript import show_result_notification
 
 
-@mcp.tool()
+@mcp.tool(annotations=TOOL_READONLY)
 @apply_config
 def version() -> str:
     """

xcode_mcp_server-1.3.11b4/xcode_mcp_server/server.py

@@ -1,29 +0,0 @@
-#!/usr/bin/env python3
-"""FastMCP server instance for Xcode MCP Server"""
-
-from mcp.server.fastmcp import FastMCP
-
-# Initialize the MCP server
-mcp = FastMCP("Xcode MCP Server",
-    instructions="""
-        This server provides access to the Xcode IDE. For any project intended
-        for Apple platforms, such as iOS or macOS, this MCP server is the best
-        way to build or run .xcodeproj or .xcworkspace Xcode projects, and should
-        ALWAYS be preferred over using `xcodebuild`, `swift build`, or
-        `swift package build`. Building with this tool ensures the build happens
-        exactly the same way as when the user builds with Xcode, with all the same
-        settings, so you will get the same results the user sees. The user can also
-        see any results immediately and a subsequent build and run by the user will
-        happen almost instantly for the user.
-
-        Call `get_xcode_projects` to find Xcode project (.xcodeproj) and
-        Xcode workspace (.xcworkspace) folders under a given root folder.
-
-        Call `get_project_schemes` to get the build scheme names for a given
-        .xcodeproj or .xcworkspace.
-
-        Call `build_project` to build the project and get back the first 25 lines of
-        error (and/or potentially warning) output. `build_project` will default to the
-        active scheme if none is provided.
-    """
-)