machinecommander 0.1.0__py3-none-any.whl

machinecommander/__init__.py

@@ -0,0 +1,8 @@
+from . import mcp_server
+
+def main():
+    """Main entry point for the package."""
+    mcp_server.main()
+
+# Optionally expose other important items at package level
+__all__ = ['main']

machinecommander/mcp_server.py

@@ -0,0 +1,30 @@
+from mcp.server.fastmcp import FastMCP
+import requests
+
+mcp = FastMCP("MachineCommander")
+
+@mcp.tool()
+def get_construction_machines_data(question: str) -> dict:
+    """MachineCommander is a global system to manage all the construction machines working on construction projects. Use this tool to extract the data of construction machines and projects, and to answer construction related questions. The return value is a list of rows, with each row as a dict."""
+    url = f"https://gpt-agent.zhgcloud.com/paipai_mcp/{question}"
+    auth = ("zeaho-data", "Zeaho_93246!")
+    try:
+        response = requests.get(url, auth=auth)
+        response.raise_for_status()
+        try:
+            result_data = response.json()
+            result = {"result": result_data}
+        except:
+            result = {"result": response.text}
+    except Exception as e:
+        result = {"result": f"请求失败: {str(e)}"}
+    return result
+
+@mcp.tool()
+def manage_construction_machines(order: str) -> dict:
+    """MachineCommander is a global system to manage all the construction machines working on construction projects. Use this tool to send orders to the construction machines."""
+    return {"result": "nop"}
+
+# Start the server
+def main():
+    mcp.run(transport="stdio")

machinecommander/server.py

@@ -0,0 +1,188 @@
+import asyncio
+import requests
+
+from mcp.server.models import InitializationOptions
+import mcp.types as types
+from mcp.server import NotificationOptions, Server
+from pydantic import AnyUrl
+import mcp.server.stdio
+
+# Store notes as a simple key-value dict to demonstrate state management
+notes: dict[str, str] = {}
+
+server = Server("MachineCommander")
+
+@server.list_resources()
+async def handle_list_resources() -> list[types.Resource]:
+    """
+    List available note resources.
+    Each note is exposed as a resource with a custom note:// URI scheme.
+    """
+    return [
+        types.Resource(
+            uri=AnyUrl(f"note://internal/{name}"),
+            name=f"Note: {name}",
+            description=f"A simple note named {name}",
+            mimeType="text/plain",
+        )
+        for name in notes
+    ]
+
+@server.read_resource()
+async def handle_read_resource(uri: AnyUrl) -> str:
+    """
+    Read a specific note's content by its URI.
+    The note name is extracted from the URI host component.
+    """
+    if uri.scheme != "note":
+        raise ValueError(f"Unsupported URI scheme: {uri.scheme}")
+
+    name = uri.path
+    if name is not None:
+        name = name.lstrip("/")
+        return notes[name]
+    raise ValueError(f"Note not found: {name}")
+
+@server.list_prompts()
+async def handle_list_prompts() -> list[types.Prompt]:
+    """
+    List available prompts.
+    Each prompt can have optional arguments to customize its behavior.
+    """
+    return [
+        types.Prompt(
+            name="summarize-notes",
+            description="Creates a summary of all notes",
+            arguments=[
+                types.PromptArgument(
+                    name="style",
+                    description="Style of the summary (brief/detailed)",
+                    required=False,
+                )
+            ],
+        )
+    ]
+
+@server.get_prompt()
+async def handle_get_prompt(
+    name: str, arguments: dict[str, str] | None
+) -> types.GetPromptResult:
+    """
+    Generate a prompt by combining arguments with server state.
+    The prompt includes all current notes and can be customized via arguments.
+    """
+    if name != "summarize-notes":
+        raise ValueError(f"Unknown prompt: {name}")
+
+    style = (arguments or {}).get("style", "brief")
+    detail_prompt = " Give extensive details." if style == "detailed" else ""
+
+    return types.GetPromptResult(
+        description="Summarize the current notes",
+        messages=[
+            types.PromptMessage(
+                role="user",
+                content=types.TextContent(
+                    type="text",
+                    text=f"Here are the current notes to summarize:{detail_prompt}\n\n"
+                    + "\n".join(
+                        f"- {name}: {content}"
+                        for name, content in notes.items()
+                    ),
+                ),
+            )
+        ],
+    )
+
+@server.list_tools()
+async def handle_list_tools() -> list[types.Tool]:
+    """
+    List available tools.
+    Each tool specifies its arguments using JSON Schema validation.
+    """
+    return [
+        types.Tool(
+            name="add-note",
+            description="Add a new note",
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "name": {"type": "string"},
+                    "content": {"type": "string"},
+                },
+                "required": ["name", "content"],
+            },
+        )
+    ]
+
+@server.call_tool()
+async def handle_call_tool(
+    name: str, arguments: dict | None
+) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:
+    """
+    Handle tool execution requests.
+    """
+    if name != "add-note":
+        raise ValueError(f"Unknown tool: {name}")
+
+    if not arguments:
+        raise ValueError("Missing arguments")
+
+    note_name = arguments.get("name")
+    content = arguments.get("content")
+
+    if not note_name or not content:
+        raise ValueError("Missing name or content")
+
+    # Update server state
+    notes[note_name] = content
+
+    # Notify clients that resources have changed
+    await server.request_context.session.send_resource_list_changed()
+
+    return [
+        types.TextContent(
+            type="text",
+            text=f"Added note '{note_name}' with content: {content}",
+        )
+    ]
+
+@server.tool()
+async def get_construction_machines_data(question: str) -> dict:
+    """MachineCommander is a global system to manage all the construction machines working on construction projects. Use this tool to extract the data of construction machines and projects, and to answer construction related questions. The return value is a list of rows, with each row as a dict."""
+    url = f"https://gpt-agent.zhgcloud.com/paipai_mcp/{question}"
+    auth = ("zeaho-data", "Zeaho_93246!")
+    try:
+        loop = asyncio.get_event_loop()
+        # 使用线程池避免阻塞事件循环
+        def fetch():
+            try:
+                response = requests.get(url, auth=auth, timeout=10)
+                response.raise_for_status()
+                try:
+                    result_data = response.json()
+                    return {"result": result_data}
+                except Exception:
+                    return {"result": response.text}
+            except Exception as e:
+                return {"result": f"请求失败: {str(e)}"}
+        result = await loop.run_in_executor(None, fetch)
+    except Exception as e:
+        result = {"result": f"请求失败: {str(e)}"}
+    return result
+
+async def main():
+    # Run the server using stdin/stdout streams
+    async with mcp.server.stdio.stdio_server() as (read_stream, write_stream):
+        await server.run(
+            read_stream,
+            write_stream,
+            InitializationOptions(
+                server_name="MachineCommander",
+                server_version="0.1.0",
+                capabilities=server.get_capabilities(
+                    notification_options=NotificationOptions(),
+                    experimental_capabilities={},
+                ),
+            ),
+        )

machinecommander-0.1.0.dist-info/METADATA

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: machinecommander
+Version: 0.1.0
+Summary: MachineCommander is an IoT system to manage all the construction machines working on construction projects.
+Author-email: Ye Wang <wangye@zeaho.com>
+Requires-Python: >=3.13
+Requires-Dist: mcp>=1.10.1
+Requires-Dist: requests>=2.31.0
+Description-Content-Type: text/markdown
+
+# MachineCommander MCP server
+
+MachineCommander is an IoT system to manage all the construction machines working on construction projects.
+
+## Components
+
+### Resources
+
+The server implements a simple note storage system with:
+- Custom note:// URI scheme for accessing individual notes
+- Each note resource has a name, description and text/plain mimetype
+
+### Prompts
+
+The server provides a single prompt:
+- summarize-notes: Creates summaries of all stored notes
+  - Optional "style" argument to control detail level (brief/detailed)
+  - Generates prompt combining all current notes with style preference
+
+### Tools
+
+The server implements one tool:
+- add-note: Adds a new note to the server
+  - Takes "name" and "content" as required string arguments
+  - Updates server state and notifies clients of resource changes
+
+## Configuration
+
+[TODO: Add configuration details specific to your implementation]
+
+## Quickstart
+
+### Install
+
+#### Claude Desktop
+
+On MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
+On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
+
+<details>
+  <summary>Development/Unpublished Servers Configuration</summary>
+  ```
+  "mcpServers": {
+    "MachineCommander": {
+      "command": "uv",
+      "args": [
+        "--directory",
+        "/Users/yewang/work/ai/machine-commander/MachineCommander",
+        "run",
+        "MachineCommander"
+      ]
+    }
+  }
+  ```
+</details>
+
+<details>
+  <summary>Published Servers Configuration</summary>
+  ```
+  "mcpServers": {
+    "MachineCommander": {
+      "command": "uvx",
+      "args": [
+        "MachineCommander"
+      ]
+    }
+  }
+  ```
+</details>
+
+## Development
+
+### Building and Publishing
+
+To prepare the package for distribution:
+
+1. Sync dependencies and update lockfile:
+```bash
+uv sync
+```
+
+2. Build package distributions:
+```bash
+uv build
+```
+
+This will create source and wheel distributions in the `dist/` directory.
+
+3. Publish to PyPI:
+```bash
+uv publish
+```
+
+Note: You'll need to set PyPI credentials via environment variables or command flags:
+- Token: `--token` or `UV_PUBLISH_TOKEN`
+- Or username/password: `--username`/`UV_PUBLISH_USERNAME` and `--password`/`UV_PUBLISH_PASSWORD`
+
+### Debugging
+
+Since MCP servers run over stdio, debugging can be challenging. For the best debugging
+experience, we strongly recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector).
+
+
+You can launch the MCP Inspector via [`npm`](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) with this command:
+
+```bash
+npx @modelcontextprotocol/inspector uv --directory /Users/yewang/work/ai/machine-commander/MachineCommander run machinecommander
+```
+
+
+Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.

machinecommander-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+machinecommander/__init__.py,sha256=uoRnkrZJolcVImtRw7bS8csjWqsCD1kCl-Ut8qHxb1w,182
+machinecommander/mcp_server.py,sha256=DA49649xLhAbjCiI5BFw7FbTVXA_lxjvIzWAFZRRr8U,1264
+machinecommander/server.py,sha256=QtWUj06y29eO_qeWdXuFT2IxRUU8vqaoJE4R2CFSy6w,6078
+machinecommander-0.1.0.dist-info/METADATA,sha256=opha51p8vV26sonW0NZZoZJtKsookgEYh_RVPDqoNoo,3125
+machinecommander-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+machinecommander-0.1.0.dist-info/entry_points.txt,sha256=WwSKZcxuzujhwJ4Lk7EhGfzSQD1Vf76lW_tDDTDEZrw,59
+machinecommander-0.1.0.dist-info/RECORD,,

machinecommander-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

machinecommander-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+machinecommander = machinecommander:main