https://github.com/modelcontextprotocol/experimental-ext-interceptors
Status: Experimental. This repository provides a multi-language reference implementation of the proposed interceptor extension for the Model Context Protocol (MCP), as described in SEP-1763.
https://github.com/modelcontextprotocol/experimental-ext-interceptors
experimental extension
Last synced: 5 months ago
JSON representation
Status: Experimental. This repository provides a multi-language reference implementation of the proposed interceptor extension for the Model Context Protocol (MCP), as described in SEP-1763.
- Host: GitHub
- URL: https://github.com/modelcontextprotocol/experimental-ext-interceptors
- Owner: modelcontextprotocol
- License: apache-2.0
- Created: 2025-12-04T00:50:02.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-01-27T23:53:48.000Z (5 months ago)
- Last Synced: 2026-01-28T06:28:16.295Z (5 months ago)
- Topics: experimental, extension
- Language: C#
- Homepage:
- Size: 136 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MCP Interceptors (Experimental Extension)
> #### **Status:** Experimental. This work is for prototyping and feedback only, and is not an accepted or official MCP extension.
This repository provides a multi-language reference implementation of the proposed interceptor extension for the Model Context Protocol (MCP), as described in [SEP-1763](https://github.com/modelcontextprotocol/modelcontextprotocol/issues/1763).
## Implementations
| Language | Directory | Package | Status |
|----------|-----------|---------|--------|
| C# | `csharp/sdk/` | `ModelContextProtocol.Interceptors` | In Progress |
| Go | `go/sdk/` | `github.com/modelcontextprotocol/ext-interceptors/go/sdk` | Planned |
| Python | `python/sdk/` | `mcp-ext-interceptors` | Planned |
| TypeScript | `typescript/sdk/` | `@ext-modelcontextprotocol/interceptors` | Planned |
## CI/CD
This monorepo uses **path-based CI workflows** to efficiently test only what changes:
### How It Works
1. **Language-specific workflows** (`csharp.yml`, `python.yml`, `go.yml`, `typescript.yml`)
- Only trigger when their language directory or workflow file changes
- Run all tests, linting, and checks for that language
2. **Status check workflow** (`status-check.yml`)
- Runs on every PR to verify required checks passed
- Determines what needs to pass based on which files changed
- This is the only required check in branch protection
### Examples
- Change `python/sdk/file.py` → Only Python CI runs → PR requires Python checks to pass
- Change both Go and TypeScript files → Both CIs run → PR requires both to pass
- Change only `README.md` → No language CIs run → PR can merge immediately
### Forcing All Checks
To run all language checks regardless of changed files:
- **In a PR**: Comment `/test all` (only works for repo owners/members/collaborators)
- **Manually**: Use GitHub Actions UI or CLI to trigger individual workflows
### Adding New Required Checks
1. **Add your check** to the appropriate language workflow (e.g., `python.yml`):
```yaml
python-security-scan:
name: "Security Scan"
runs-on: ubuntu-latest
steps:
- name: Run security checks
run: # your commands here
```
2. **Update the status check** in `.github/workflows/status-check.yml`:
```javascript
const requiredChecks = {
python: [
'Python CI / Linting',
'Python CI / Unit Tests (3.10)',
// ... existing checks ...
'Python CI / Security Scan' // ← Add your new check
],
```
3. **Submit PR** - Your new check is now required for all relevant changes!
## License
Apache License 2.0 - See LICENSE file for details
## Resources
- [Interceptor Framework Specification (SEP-1763)](https://github.com/modelcontextprotocol/modelcontextprotocol/issues/1763) - Full specification and design details
- [Model Context Protocol](https://modelcontextprotocol.io/specification)