Minecraft生成设计桥接器

# Clone the repository
git clone https://github.com/natea/fastmcp-gdmc-bridge.git
cd fastmcp-gdmc-bridge

# Create and activate a virtualenv
python -m venv venv
source venv/bin/activate

# Install dependencies
pip install -e .

# Start the server with stdio transport (for AI assistants)
python -m gdmc_mcp.server

# Or start with SSE transport (for web applications)
fastmcp run gdmc_mcp.server --transport sse

import asyncio
from fastmcp import Client

async def main():
    # Connect to the server
    async with Client() as client:
        # Get the build area
        build_area = await client.access_resource("gdmc://build_area")
        print(f"Build area: {build_area}")
        
        # Place a block
        result = await client.use_tool(
            "place_block",
            {
                "position": {"coords": [0, 65, 0]},
                "block": {"id": "stone"}
            }
        )
        print(f"Block placed: {result}")
        
        # Build a house with transformation
        result = await client.use_tool(
            "build_with_transform",
            {
                "position": {"coords": [10, 65, 10]},
                "rotation": 1,
                "flip": [False, False, False],
                "build_function": "house",
                "size": 7,
                "block": "oak_planks"
            }
        )
        print(f"House built: {result}")

if __name__ == "__main__":
    asyncio.run(main())

fastmcp-gdmc-bridge/
├── src/
│   ├── gdmc_mcp/
│   │   ├── __init__.py
│   │   ├── server.py
│   │   ├── models.py
│   │   ├── gdpc_utils.py
│   │   ├── tutorial_tools.py
│   │   └── py.typed
│   ├── client.py
│   └── client_example.py
├── tests/
│   ├── conftest.py
│   ├── test_models.py
│   ├── test_place_block_tool.py
│   ├── test_run_command_tool.py
│   ├── test_place_cuboid_tool.py
│   ├── test_place_entities_tool.py
│   ├── test_place_structure_tool.py
│   ├── test_resources.py
│   ├── test_server_lifespan.py
│   ├── run_tests.py
│   └── README.md
├── pyproject.toml
└── README.md

# Install test dependencies
pip install pytest pytest-asyncio pytest-cov

# Run all tests
cd fastmcp-gdmc-bridge
./tests/run_tests.py

# Run with coverage report
./tests/run_tests.py --cov

# Run specific test file
./tests/run_tests.py --test-file test_place_block_tool.py

# Run with verbose output
./tests/run_tests.py --verbose

@mcp.tool()
async def my_new_tool(
    param1: Annotated[str, Field(description="Description of param1")],
    ctx: Context
) -> dict[str, Any]:
    """Tool description."""
    editor = _get_editor(ctx)
    # Implement tool functionality
    return {"result": "success"}