You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CLAUDE.md
+43-46Lines changed: 43 additions & 46 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
4
4
5
5
## Project Overview
6
6
7
-
This is a Cheat Engine MCP (Model Context Protocol) Server that provides REST API access to Cheat Engine functionality through a C# plugin and Python MCP client. The project enables AI tools to interact with Cheat Engine for memory analysis, process manipulation, and debugging tasks.
7
+
This is a Cheat Engine MCP (Model Context Protocol) Server that provides MCP tool access to Cheat Engine functionality through a C# plugin using the official MCP C# SDK. The project enables AI tools to interact with Cheat Engine for memory analysis, process manipulation, and debugging tasks via Server-Sent Events (SSE).
8
8
9
9
## Build Commands
10
10
@@ -39,19 +39,14 @@ uv sync
39
39
- Registers Lua functions for CE integration
40
40
- Provides configuration UI through WPF window
41
41
42
-
-**McpServer.cs**: OWIN-based web server that hosts the REST API
43
-
- Uses Web API with Swagger documentation
42
+
-**McpServer.cs**: MCP SSE server using the official Model Context Protocol C# SDK
43
+
- Exposes all Cheat Engine functionality as MCP tools
44
+
- Runs in SSE (Server-Sent Events) mode for compatibility with CE plugin environment
44
45
- Configurable host/port via environment variables or config file
45
46
46
-
-**CheatEngineController.cs**: Main API controller with endpoints for:
47
-
- Lua execution
48
-
- Process management
49
-
- Memory reading/writing
50
-
- AOB scanning
51
-
- Disassembly
52
-
- Memory scanning
53
-
54
47
-**CheatEngineTools.cs**: Service layer that delegates to specialized tools in `/Tools` directory
-**cheat_engine_mcp_server.py**: FastMCP-based server that exposes tools for AI interaction
78
-
- Provides async wrappers for all REST API endpoints
79
-
- Uses httpx for HTTP communication with configurable timeout (600s)
72
+
Note: The Python MCP client is now deprecated as the C# plugin directly implements the MCP protocol using the official SDK. You can connect directly to the MCP SSE server from any MCP-compatible client.
80
73
81
74
## Development Workflow
82
75
83
76
1. Build the C# plugin with `dotnet build`
84
77
2. Copy `ce-mcp.dll` from `bin/` to Cheat Engine plugins directory
85
78
3. Enable the plugin in Cheat Engine
86
79
4. Use "MCP" menu to start/configure the server
87
-
5.Test endpoints at `http://localhost:6300/swagger`
80
+
5.Connect to the MCP SSE server at `http://localhost:6300` using any MCP-compatible client
88
81
89
82
## Adding New Tools
90
83
91
-
To add a new tool/endpoint to the MCP server:
84
+
To add a new MCP tool to the server:
92
85
93
86
**Important**: Always examine existing implementations first. Look at similar tools in `/Tools`, models in `/Models`, and SDK wrappers in `/SDK` to understand patterns and conventions.
94
87
@@ -152,43 +145,47 @@ public NewFeatureResponse DoSomething(NewFeatureRequest request)
152
145
}
153
146
```
154
147
155
-
### 5. Add Controller Endpoint
156
-
Add endpoint to `CheatEngineController.cs`:
148
+
### 5. Add MCP Tool in McpServer.cs
149
+
Add the MCP tool definition in the `ConfigureTools` method in `McpServer.cs`:
0 commit comments