Zed Python Context Server
https://github.com/zed-industries/python-context-server- Category
- Developer Tools
- Rank
- No. 1841Tools index
Previous survey · No. 1849 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- zed-industries
- GitHub
- 15 stars
- Date
About
Python context server for the Zed editor, exposing project context to AI features through the MCP-style protocol.
What it does
A small Python framework for turning asynchronous functions into Zed Assistant slash commands. Decorators attach command descriptions and typed argument metadata, while a server loop reads JSON-RPC requests from standard input and writes responses to standard output.
Why it's ranked here
Its narrow design is the main attraction. A short example demonstrates the complete path from command declaration to Zed configuration, and the implementation handles discovery, execution, protocol errors, and response formatting. The limited protocol surface makes it better suited to focused extensions than broad integrations.
What's good
Command registration needs little boilerplate, while argument names, types, and help text stay beside the command implementation. Command discovery exposes useful metadata to Zed. Unknown methods, missing commands, handler failures, and malformed JSON receive structured JSON-RPC errors. Unit tests cover registration, argument ordering, discovery, and execution.
Tradeoffs
Every advertised argument is marked required, regardless of Python defaults or richer typing needs. Declared types become metadata only, with no visible validation or conversion. The server implements initialization plus prompt listing and retrieval, but no broader resource or tool capabilities. Installation requires cloning the repository before using pip.
How to use it well
Use it for small, custom Zed slash commands backed by asynchronous Python, especially transformations or project-specific helpers with simple required inputs. Keep validation and error handling inside each command. Choose another foundation when you need resources, general tools, optional argument schemas, transport choices, or editor-independent integration.
Technical notes+
context_server/context_server.py defines ContextServer, stores commands and metadata in dictionaries, dispatches initialize, prompts/list, and prompts/get, and exchanges one JSON object per stdin line through stdout. slash_command and argument use functools.wraps; argument types are serialized through type.__name__, while invocation forwards the supplied argument dictionary directly to the async command. context_server/__init__.py exports ContextServer. context_server/context_server_test.py uses unittest to cover registration, multiple argument ordering, execution, and prompt listing. examples/rot13.py provides a runnable command. pyproject.toml configures setuptools package discovery and excludes names matching *_test.
Observed
- License
- GNU General Public License version 3
- Primary language
- Python
- Python requirement
- Python 3.9 or newer
- Packaging
- setuptools build backend with installation documented through pip from a cloned repository
- Interface
- JSON-RPC over standard input and standard output, exposing initialization and prompt list/get methods
- Editor integration
- Configured in Zed settings as a Python module or script executable
- Tests
- A unittest module covers command registration, arguments, execution, and prompt discovery
Read from README.md, pyproject.toml, context_server/__init__.py, context_server/context_server.py, context_server/context_server_test.py, examples/rot13.py, LICENSE.
What it can do
Expose Python project structure to AI features
Python project files and directories → Structured project context data
Provide code context through MCP protocol
Python source code files → Formatted code context for AI consumption
Extract function and class definitions
Python files with functions and classes → Structured metadata about code components
Analyze import dependencies
Python files with import statements → Dependency relationship data
Serve contextual information to Zed editor
Project analysis requests from Zed → Relevant code context responses
Bridge Python project data to AI models
Raw Python project files → AI-readable project context
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.