Skip to content

Commit e75a852

Browse files
zc277584121zc277584121
authored
docs(mcp): rename the claude-context example so its purpose is obvious (#155)
examples/mfs-mcp -> examples/claude-context, and the registered MCP server name mfs-context -> claude-context. The example is a direct replica of zilliztech/claude-context rebuilt on MFS's search + read API; the old name gave no hint which project it was reproducing. Reworded the surrounding docs (README, docs/integrations/mcp.md, server.py docstring) to say so directly instead of "in the spirit of". Signed-off-by: Cheney Zhang <chen.zhang@zilliz.com>
1 parent 18580ab commit e75a852

3 files changed

Lines changed: 30 additions & 30 deletions

File tree

‎docs/integrations/mcp.md‎

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,25 @@
1-
# MCP server
1+
# MCP server: a claude-context replica
22

3-
Expose MFS over the [Model Context Protocol](https://modelcontextprotocol.io) and
4-
any MCP client — Claude Code, Cursor, Codex, Windsurf — can search your indexed
5-
sources as context. It's in the spirit of
3+
MFS ships a replica of
64
[claude-context](https://github.com/zilliztech/claude-context) ("make the codebase
7-
the context for any coding agent"), but the index is MFS, so one server covers
5+
the context for any coding agent"), rebuilt on top of MFS and exposed over the
6+
[Model Context Protocol](https://modelcontextprotocol.io) for any MCP client —
7+
Claude Code, Cursor, Codex, Windsurf. Because the index is MFS, one server covers
88
**every** source you've indexed — code, docs, issues, chat, databases — not just
99
one codebase.
1010

1111
The runnable server is in the
12-
[example](https://github.com/zilliztech/mfs/tree/main/examples/mfs-mcp); it's about
13-
60 lines over the [Python SDK](../sdks.md).
12+
[example](https://github.com/zilliztech/mfs/tree/main/examples/claude-context);
13+
MFS's `search` + `read` API is enough to reproduce it in about 60 lines over the
14+
[Python SDK](../sdks.md).
1415

1516
## Two tools
1617

1718
```python
1819
from mcp.server.fastmcp import FastMCP
1920
import mfs_sdk
2021

21-
mcp = FastMCP("mfs-context")
22+
mcp = FastMCP("claude-context")
2223

2324

2425
@mcp.tool()
@@ -73,12 +74,12 @@ MFS runs fully local — ONNX embeddings + Milvus Lite, no keys.)
7374
With Claude Code, from your project:
7475

7576
```bash
76-
claude mcp add mfs-context \
77+
claude mcp add claude-context \
7778
--env MFS_URL=http://127.0.0.1:13619 \
78-
-- uv run --with mcp --with /abs/path/to/mfs/sdks/python python /abs/path/to/mfs/examples/mfs-mcp/server.py
79+
-- uv run --with mcp --with /abs/path/to/mfs/sdks/python python /abs/path/to/mfs/examples/claude-context/server.py
7980
```
8081

81-
`claude mcp list` should report `mfs-context: ✔ Connected`, after which the agent
82+
`claude mcp list` should report `claude-context: ✔ Connected`, after which the agent
8283
calls the tools on its own — "where is rate limiting implemented? search our
8384
sources." Any MCP client works; point its stdio server config at the same command.
8485

examples/mfs-mcp/README.md renamed to examples/claude-context/README.md

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,10 @@
1-
# MFS MCP server
1+
# claude-context, on MFS
22

3-
A tiny [Model Context Protocol](https://modelcontextprotocol.io) server that turns
4-
MFS into searchable context for any MCP client — Claude Code, Cursor, Codex,
5-
Windsurf, and the rest.
6-
7-
It's in the spirit of [`claude-context`](https://github.com/zilliztech/claude-context)
8-
("make the codebase the context for any coding agent"), but the index is MFS, so a
3+
A replica of [`claude-context`](https://github.com/zilliztech/claude-context)
4+
("make the codebase the context for any coding agent"), rebuilt on top of MFS: a
5+
tiny [Model Context Protocol](https://modelcontextprotocol.io) server for any MCP
6+
client — Claude Code, Cursor, Codex, Windsurf, and the rest. MFS's `search` + `read`
7+
API is enough to reproduce it in about 60 lines — and because the index is MFS, this
98
single server covers **every source you've indexed** — code, docs, issues, chat,
109
databases — not just one codebase.
1110

@@ -57,12 +56,12 @@ choice lives with MFS, not here.
5756
With Claude Code, from your project:
5857

5958
```bash
60-
claude mcp add mfs-context \
59+
claude mcp add claude-context \
6160
--env MFS_URL=http://127.0.0.1:13619 \
62-
-- uv run --with mcp --with /abs/path/to/mfs/sdks/python python /abs/path/to/mfs/examples/mfs-mcp/server.py
61+
-- uv run --with mcp --with /abs/path/to/mfs/sdks/python python /abs/path/to/mfs/examples/claude-context/server.py
6362
```
6463

65-
`claude mcp list` should report `mfs-context: ✔ Connected`. Then just ask — the
64+
`claude mcp list` should report `claude-context: ✔ Connected`. Then just ask — the
6665
agent calls `search` / `read` on its own:
6766

6867
> Where is rate limiting implemented? Search our indexed sources.
@@ -79,10 +78,10 @@ To bound it, set `MFS_ALLOWED_SCOPES` to a comma-separated list of URI / path
7978
prefixes when you register it:
8079

8180
```bash
82-
claude mcp add mfs-context \
81+
claude mcp add claude-context \
8382
--env MFS_URL=http://127.0.0.1:13619 \
8483
--env MFS_ALLOWED_SCOPES=github://your-org/your-repo,file://local/abs/path \
85-
-- uv run --with mcp --with /abs/path/to/mfs/sdks/python python /abs/path/to/mfs/examples/mfs-mcp/server.py
84+
-- uv run --with mcp --with /abs/path/to/mfs/sdks/python python /abs/path/to/mfs/examples/claude-context/server.py
8685
```
8786

8887
`search` then only returns hits under those prefixes — an empty scope searches all

examples/mfs-mcp/server.py renamed to examples/claude-context/server.py

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
#!/usr/bin/env python3
2-
"""An MCP server that turns MFS into searchable context for any MCP client.
3-
4-
In the spirit of zilliztech/claude-context — "make the codebase the context for
5-
any coding agent" — but the index is MFS, so a single server covers every source
6-
you've indexed (code, docs, issues, chat, databases), not just one codebase.
2+
"""A replica of zilliztech/claude-context ("make the codebase the context for any
3+
coding agent"), rebuilt on top of MFS instead of a single-codebase index. MFS's
4+
`search` + `read` API is enough to reproduce it in about 60 lines — and because the
5+
index is MFS, this single server covers every source you've indexed (code, docs,
6+
issues, chat, databases), not just one codebase.
77
88
It exposes two tools over the Model Context Protocol:
99
@@ -14,7 +14,7 @@
1414
``http://127.0.0.1:13619`` and ``~/.mfs/server.token``). Register it with any MCP
1515
client, e.g. Claude Code:
1616
17-
claude mcp add mfs-context -- python /abs/path/to/server.py
17+
claude mcp add claude-context -- python /abs/path/to/server.py
1818
"""
1919

2020
from __future__ import annotations
@@ -25,7 +25,7 @@
2525
import mfs_sdk
2626
from mcp.server.fastmcp import FastMCP
2727

28-
mcp = FastMCP("mfs-context")
28+
mcp = FastMCP("claude-context")
2929

3030
# Optional access boundary: a comma-separated list of URI / path prefixes this
3131
# server may search and read. Empty = unrestricted (the whole MFS index). Set it

0 commit comments

Comments
 (0)