Skip to content

Commit 0fdee06

Browse files
aksOpsclaude
andcommitted
feat(mcp): rename server to "CODE MCP" + ship project-scoped .mcp.json
The MCP protocol-level server name was returned as "codeiq" via spring.ai.mcp.server.name. Renamed to "CODE MCP" so clients see a distinctive identifier separate from the project/CLI name (which remains "codeiq"). Also commits a project-scoped .mcp.json at the repo root: cloning the repo and opening it in Claude Code auto-registers the MCP server at http://localhost:8080/mcp without manual `claude mcp add`. Documented the user-scope registration command in README for cross-project use. No backend behavior change. Auth defaults are unchanged (mode=none + allow_unauthenticated=true since v0.2.0 / PR #112), so the server remains discoverable on a fresh `codeiq serve`. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent f7e792e commit 0fdee06

4 files changed

Lines changed: 24 additions & 1 deletion

File tree

.mcp.json

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"mcpServers": {
3+
"code-mcp": {
4+
"type": "http",
5+
"url": "http://localhost:8080/mcp"
6+
}
7+
}
8+
}

CLAUDE.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -227,6 +227,9 @@ codeiq serve /path/to/repo # needs enrich if using index
227227
- `GET /api/intelligence/capabilities` -- Capability matrix
228228

229229
### MCP Tools (34, via `@McpTool` annotation)
230+
231+
The protocol-level server name is **`CODE MCP`** (set via `spring.ai.mcp.server.name` in `application.yml`). Project-scoped registration lives in `.mcp.json` at the repo root.
232+
230233
`get_stats`, `get_detailed_stats`, `query_nodes`, `query_edges`, `get_node_neighbors`, `get_ego_graph`, `find_cycles`, `find_shortest_path`, `find_consumers`, `find_producers`, `find_callers`, `find_dependencies`, `find_dependents`, `find_dead_code`, `generate_flow`, `run_cypher`, `find_component_by_file`, `trace_impact`, `find_related_endpoints`, `search_graph`, `read_file`, `get_topology`, `service_detail`, `service_dependencies`, `service_dependents`, `blast_radius`, `find_path`, `find_bottlenecks`, `find_circular_deps`, `find_dead_services`, `find_node`, `get_evidence_pack`, `get_artifact_metadata`, `get_capabilities`
231234

232235
## Adding a New Detector

README.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,18 @@ java -jar target/code-iq-*-cli.jar serve /path/to/repo
3535
# Open http://localhost:8080
3636
```
3737

38+
### Use with Claude Code (MCP)
39+
40+
While `serve` is running, register the MCP server once on your machine:
41+
42+
```bash
43+
claude mcp add --scope user code-mcp -t http http://localhost:8080/mcp
44+
```
45+
46+
The server publishes itself as **`CODE MCP`**. Inside this repo a project-scoped
47+
`.mcp.json` is committed at the root, so cloning + opening in Claude Code
48+
auto-registers it for codeiq development without the manual step.
49+
3850
## How It Works
3951

4052
codeiq scans source files using 99 detectors across 35+ languages, builds a knowledge graph of code relationships, and serves it via REST API, MCP server, and React UI.

src/main/resources/application.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ codeiq:
5757
enabled: true
5858

5959
spring.ai.mcp.server:
60-
name: codeiq
60+
name: "CODE MCP"
6161
version: 0.1.0
6262
protocol: STREAMABLE
6363
streamable-http:

0 commit comments

Comments
 (0)