Skip to content

Commit 4606e0d

Browse files
docs: add Go and C# SDK examples to README and SKILL.md
1 parent 771adf5 commit 4606e0d

2 files changed

Lines changed: 61 additions & 2 deletions

File tree

.claude/skills/mcp-sdk-tier-audit/README.md

Lines changed: 54 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -121,6 +121,29 @@ uv run mcp-everything-server --port 3001
121121
/mcp-sdk-tier-audit ~/src/mcp/python-sdk http://localhost:3001/mcp "uv run python ~/src/mcp/python-sdk/.github/actions/conformance/client.py"
122122
```
123123

124+
**Go SDK example:**
125+
126+
```bash
127+
# Terminal 1: build and start the everything server
128+
cd ~/src/mcp/go-sdk && go build -o /tmp/go-conformance-server ./conformance/everything-server
129+
go build -o /tmp/go-conformance-client ./conformance/everything-client
130+
/tmp/go-conformance-server -http="localhost:3002"
131+
132+
# Terminal 2: run the audit (from the conformance repo)
133+
/mcp-sdk-tier-audit ~/src/mcp/go-sdk http://localhost:3002 "/tmp/go-conformance-client"
134+
```
135+
136+
**C# SDK example:**
137+
138+
```bash
139+
# Terminal 1: start the everything server (requires .NET SDK)
140+
cd ~/src/mcp/csharp-sdk
141+
dotnet run --project tests/ModelContextProtocol.ConformanceServer -- --urls http://localhost:3003
142+
143+
# Terminal 2: run the audit (from the conformance repo)
144+
/mcp-sdk-tier-audit ~/src/mcp/csharp-sdk http://localhost:3003 "dotnet run --project ~/src/mcp/csharp-sdk/tests/ModelContextProtocol.ConformanceClient"
145+
```
146+
124147
The skill derives `owner/repo` from git remote, runs the CLI, launches parallel evaluations for docs and policy, and writes detailed reports to `results/`.
125148

126149
### Any Other AI Coding Agent
@@ -189,7 +212,37 @@ npm run --silent tier-check -- \
189212
--client-cmd 'uv run python ~/src/mcp/python-sdk/.github/actions/conformance/client.py'
190213
```
191214

192-
**Other SDKs:** Your SDK needs an "everything server" — an HTTP server at `/mcp` implementing the [Streamable HTTP transport](https://modelcontextprotocol.io/specification/draft/basic/transports.md) with all MCP features (tools, resources, prompts, etc.). See the [TypeScript](https://github.com/modelcontextprotocol/typescript-sdk/tree/v1.x/test/conformance) or [Python](https://github.com/modelcontextprotocol/python-sdk/tree/v1.x/examples/servers/everything-server) implementations as reference.
215+
**Go SDK**:
216+
217+
```bash
218+
# Terminal 1: build and start the server
219+
cd ~/src/mcp/go-sdk
220+
go build -o /tmp/go-conformance-server ./conformance/everything-server
221+
go build -o /tmp/go-conformance-client ./conformance/everything-client
222+
/tmp/go-conformance-server -http="localhost:3002"
223+
224+
# Terminal 2: run tier-check (server + client conformance)
225+
npm run --silent tier-check -- \
226+
--repo modelcontextprotocol/go-sdk \
227+
--conformance-server-url http://localhost:3002 \
228+
--client-cmd '/tmp/go-conformance-client'
229+
```
230+
231+
**C# SDK**:
232+
233+
```bash
234+
# Terminal 1: start the server (requires .NET SDK)
235+
cd ~/src/mcp/csharp-sdk
236+
dotnet run --project tests/ModelContextProtocol.ConformanceServer -- --urls http://localhost:3003
237+
238+
# Terminal 2: run tier-check (server + client conformance)
239+
npm run --silent tier-check -- \
240+
--repo modelcontextprotocol/csharp-sdk \
241+
--conformance-server-url http://localhost:3003 \
242+
--client-cmd 'dotnet run --project ~/src/mcp/csharp-sdk/tests/ModelContextProtocol.ConformanceClient'
243+
```
244+
245+
**Other SDKs:** Your SDK needs an "everything server" — an HTTP server implementing the [Streamable HTTP transport](https://modelcontextprotocol.io/specification/draft/basic/transports.md) with all MCP features (tools, resources, prompts, etc.). See the implementations above as reference.
193246

194247
Start your everything server, then pass `--conformance-server-url`. Pass `--client-cmd` if your SDK has a conformance client. If neither exists yet, use `--skip-conformance` — the scorecard will note this as a gap.
195248

.claude/skills/mcp-sdk-tier-audit/SKILL.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -232,6 +232,12 @@ Read these reference files when you need the detailed content for evaluation pro
232232
# Python SDK — server + client conformance
233233
/mcp-sdk-tier-audit ~/src/mcp/python-sdk http://localhost:3001/mcp "uv run python ~/src/mcp/python-sdk/.github/actions/conformance/client.py"
234234
235+
# Go SDK — server + client conformance
236+
/mcp-sdk-tier-audit ~/src/mcp/go-sdk http://localhost:3002 "/tmp/go-conformance-client"
237+
238+
# C# SDK — server + client conformance
239+
/mcp-sdk-tier-audit ~/src/mcp/csharp-sdk http://localhost:3003 "dotnet run --project ~/src/mcp/csharp-sdk/tests/ModelContextProtocol.ConformanceClient"
240+
235241
# Any SDK — server conformance only (no client)
236-
/mcp-sdk-tier-audit ~/src/mcp/go-sdk http://localhost:3002/mcp
242+
/mcp-sdk-tier-audit ~/src/mcp/some-sdk http://localhost:3004
237243
```

0 commit comments

Comments
 (0)