mcp-server-core 0.2.2__tar.gz → 0.2.3__tar.gz

{mcp_server_core-0.2.2/mcp_server_core.egg-info → mcp_server_core-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-server-core
-Version: 0.2.2
+Version: 0.2.3
 Summary: Universal MCP Server Framework: Streamable HTTP ASGI, Cloudflare Tunnel, OAuth 2.1 & Process Supervisor
 Author: yimmr
 License-Expression: MIT

mcp_server_core-0.2.3/mcp_framework/response.py

@@ -0,0 +1 @@
+from mcp_server_core.response import *  # noqa: F401, F403

{mcp_server_core-0.2.2 → mcp_server_core-0.2.3}/mcp_server_core/__init__.py

@@ -25,6 +25,7 @@ from .process import (
     kill_stale_server_process,
     stop_mcp_service,
 )
+from .response import ToolResultListDict
 from .server import (
     build_mcp_server_app,
     record_pid,
@@ -64,6 +65,7 @@ __all__ = [
     "get_client_ip",
     "get_server_public_url",
     "verify_pkce",
+    "ToolResultListDict",
     "build_mcp_server_app",
     "record_pid",
     "cleanup_pid",

mcp_server_core-0.2.3/mcp_server_core/response.py

@@ -0,0 +1,59 @@
+"""Structured response containers and protocol helpers for MCP tools."""
+from __future__ import annotations
+
+from typing import Any
+
+
+class ToolResultListDict(dict):
+    """Structured container that ensures atomic, single-block MCP response serialization while preserving list semantics.
+
+    FastMCP converts any returned Python list into multiple separate TextContent blocks
+    in the MCP protocol response. When intermediate MCP gateways or LLM clients parse
+    the response, many gateways only inspect the last TextContent block, resulting in
+    truncation (e.g. only returning the last project, file, or item).
+
+    ToolResultListDict inherits from dict so FastMCP serializes the ENTIRE structure
+    into a single TextContent JSON payload:
+    {"status": "success", "count": N, "total": N, "<key>": items, "entries": items}
+
+    Simultaneously, for Python unit tests and backward compatibility, it implements
+    list-like iteration (__iter__), indexing (__getitem__ for int), length (__len__),
+    and membership (__contains__).
+    """
+
+    def __init__(
+        self,
+        items: list[Any],
+        key: str = "items",
+        status: str = "success",
+        **extra: Any,
+    ) -> None:
+        super().__init__()
+        self["status"] = status
+        self["total"] = len(items)
+        self["count"] = len(items)
+        self[key] = items
+        if key != "entries":
+            self["entries"] = items
+        for k, v in extra.items():
+            self[k] = v
+        self._items = items
+
+    def __iter__(self):
+        return iter(self._items)
+
+    def __len__(self) -> int:
+        return len(self._items)
+
+    def __getitem__(self, item: Any) -> Any:
+        if isinstance(item, int):
+            return self._items[item]
+        return super().__getitem__(item)
+
+    def __contains__(self, item: Any) -> bool:
+        try:
+            if super().__contains__(item):
+                return True
+        except TypeError:
+            pass
+        return item in self._items

{mcp_server_core-0.2.2 → mcp_server_core-0.2.3}/mcp_server_core/server.py

@@ -154,8 +154,10 @@ async def serve_http(
         print(f"  * 官方 MCP 门户:   {portal_url}  (ChatGPT 统一端点)")
     if upstream_mcp_url:
         print(f"  * 内部隧道回源:    {upstream_mcp_url}")
+    show_key = "--show-key" in sys.argv
     if env_cfg.require_auth:
-        print(f"  * 安全访问密钥:    {env_cfg.api_key}")
+        key_display = env_cfg.api_key if show_key else "已配置 (运行传 --show-key 查看明文)"
+        print(f"  * 安全访问密钥:    {key_display}")
     print("-" * 76)
 
     print("  【远程 Agent 配置指引 (Remote Agent Connection Guide)】")
@@ -164,19 +166,22 @@ async def serve_http(
         print(f"  [ChatGPT Developer Mode / Custom Actions 连接指南]:")
         print(f"    * 服务器 URL:       {primary_endpoint}")
         print(f"    * 身份验证类型:     Bearer Token 或 OAuth")
-        print(f"    * 访问密钥:         {env_cfg.api_key}")
+        key_hint = env_cfg.api_key if show_key else "请从本机安全配置获取 (日志不显示明文)"
+        print(f"    * 访问密钥:         {key_hint}")
         print(f"    * 备用直连回源地址: {upstream_mcp_url}\n")
 
         if env_cfg.require_auth:
+            token_display = env_cfg.api_key if show_key else "<MCP_API_KEY>"
             print(f"  [通用远程 Agent (网页端/Cursor/Claude Desktop/API)]: ")
-            print(f"    * 单 URL 快捷接入:  {primary_endpoint}?token={env_cfg.api_key}")
-            print(f"    * Header 接入:      Authorization: Bearer {env_cfg.api_key}")
+            print(f"    * 单 URL 快捷接入:  {primary_endpoint}?token={token_display}")
+            print(f"    * Header 接入:      Authorization: Bearer {token_display}")
         else:
             print(f"  URL: {primary_endpoint}")
     else:
         if env_cfg.require_auth:
+            token_display = env_cfg.api_key if show_key else "<MCP_API_KEY>"
             print(f"  URL:    {local_mcp_url}")
-            print(f"  Header: Authorization: Bearer {env_cfg.api_key}")
+            print(f"  Header: Authorization: Bearer {token_display}")
         else:
             print(f"  URL:    {local_mcp_url}")
 

{mcp_server_core-0.2.2 → mcp_server_core-0.2.3/mcp_server_core.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-server-core
-Version: 0.2.2
+Version: 0.2.3
 Summary: Universal MCP Server Framework: Streamable HTTP ASGI, Cloudflare Tunnel, OAuth 2.1 & Process Supervisor
 Author: yimmr
 License-Expression: MIT

{mcp_server_core-0.2.2 → mcp_server_core-0.2.3}/mcp_server_core.egg-info/SOURCES.txt

@@ -6,6 +6,7 @@ mcp_framework/env.py
 mcp_framework/http_server.py
 mcp_framework/oauth.py
 mcp_framework/process.py
+mcp_framework/response.py
 mcp_framework/server.py
 mcp_framework/tunnel.py
 mcp_server_core/__init__.py
@@ -13,6 +14,7 @@ mcp_server_core/env.py
 mcp_server_core/http_server.py
 mcp_server_core/oauth.py
 mcp_server_core/process.py
+mcp_server_core/response.py
 mcp_server_core/server.py
 mcp_server_core/tunnel.py
 mcp_server_core.egg-info/PKG-INFO

{mcp_server_core-0.2.2 → mcp_server_core-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mcp-server-core"
-version = "0.2.2"
+version = "0.2.3"
 description = "Universal MCP Server Framework: Streamable HTTP ASGI, Cloudflare Tunnel, OAuth 2.1 & Process Supervisor"
 readme = "README.md"
 requires-python = ">=3.10"