Ecss
БесплатноНе проверенEuropean Cooperation for Space Standardization (ECSS) MCP server for easy access of ECSS documents.
Описание
European Cooperation for Space Standardization (ECSS) MCP server for easy access of ECSS documents.
README
License: Apache 2.0 Python 3.14+ MCP Docker
European Cooperation for Space Standardization (ECSS) MCP server for easy access of ECSS documents.
Overview
This MCP server is built with FastMCP and containerized with Docker. It provides three tools for retrieving information from ECSS system documents.
Features
- Document Lookup: Retrieve a list of all ECSS document IDs available in the document library, along with their scope and full table of contents.
- Agentic Search: Extract text from specific sections of any ECSS document by section number and heading, enabling LLMs to navigate and query standards content iteratively.
- Skill Integration: searching-ecss skill available to improve query results.
Tools
1. get_doc_ids
Get a list of all document IDs available in the document library.
Parameters: None
Returns: List of document ID strings for all .docx files in the document library
Example usage in Copilot Chat:
/searching-ecss What ECSS documents are available in the ecss-mcp-server?
2. get_doc_summary
Get a summary of a document including its scope and table of contents.
Integration pattern: Call get_doc_ids first to find valid document IDs before using this tool.
Parameters:
doc_id(string): The ECSS document ID (e.g.ECSS-E-ST-32)
Returns: String containing the document scope, table of contents (section numbers and headings), and list of figures and tables
Example usage in Copilot Chat:
/searching-ecss Give me a summary of ECSS-E-ST-32 using the ecss-mcp-server.
3. get_section
Extract the full text and tables of a specific section from a document.
Integration pattern: Call get_doc_summary first to get the table of contents, then use section numbers and headings exactly as they appear there.
Parameters:
doc_id(string): The ECSS document ID (e.g.ECSS-E-ST-32)section(string): The section number as it appears in the table of contents (e.g."5.5.3")heading(string): The section heading as it appears in the table of contents (e.g."Thermal Analysis")
Returns: String containing all paragraph text in the specified section
Example usage in Copilot Chat:
/searching-ecss Get the requirements from section 4.2 of ECSS-E-ST-32 using the ecss-mcp-server.
Prerequisites
- Docker: Ensure Docker is installed and running on your system
- VS Code: Latest version with GitHub Copilot extension enabled
Installation & Setup
1. Clone the repository locally
Navigate to the location you wish to store the repository and clone it:
git clone https://github.com/aerospace-mcp-tools/ecss-mcp-server.git
2. Certificate Setup (Corporate Networks Only)
If you're behind a corporate firewall using Zscaler or similar proxy:
- Obtain your organization's root certificate
- Copy the certificate file to the repository root
- Rename it to
zscaler-root-ca.crt
See SECURITY.md for using Docker with Zscaler
3. Download ECSS documents
Download the ECSS system documents to the documents folder. If looking for all the standards they can be found here: ECSS Website
Useful zip files containing all the standards can be found here: ECSS Zip Files. Handbooks are not available as a zip file so must be downloaded individually.
Documents can be saved in either .doc or .docx format — the server will automatically convert .doc files to .docx at build time and simplify filenames to the ECSS document ID (e.g. ECSS-E-ST-32C.docx).
4. Build the Docker Image
Navigate to the repository directory and build the Docker image:
docker build -t ecss-mcp-server .
This command:
- Downloads Python 3.14 base image
- Installs required dependencies using UV package manager
- Configures Docker for Zscaler
- Sets up the FastMCP server environment
5. Verify Installation
Test that the server builds and runs correctly:
docker run -it --name test ecss-mcp-server
You should see the FastMCP startup banner:
Stop the test container and clean up:
docker stop test
docker rm test
6. Configure Skills
If required, copy the searching-ecss skill to your working repository to improve query results.
VS Code Integration
This MCP server works with any MCP-compatible client that supports stdio transport. Each client will have its own configuration file location and JSON structure, but all use the same Docker container and command. The example given below shows integration with Github Copilot on VS Code.
Method 1: Using VS Code Command Palette (Recommended)
Open VS Code and press
Ctrl+Shift+P(Windows/Linux) orCmd+Shift+P(macOS)Type and select "MCP: Add Server"
Choose "Command (stdio)" as the transport type
Enter the Docker command:
docker run --rm -i --network host ecss-mcp-serverName the server:
ecss-mcp-serverThe server will be automatically added to your MCP configuration
Method 2: Manual Configuration
Alternatively, you can manually edit your MCP configuration file:
Location: %APPDATA%\Code\User\mcp.json (Windows) or ~/.config/Code/User/mcp.json (Linux/macOS)
Add the following configuration:
{
"servers": {
"ecss-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--network",
"host",
"ecss-mcp-server"
]
}
}
}
Verification
- Restart VS Code after configuration
- Open GitHub Copilot Chat
- Test the mcp server with an example from above!
Data Source
- Standards: Standards can be downloaded from the ECSS Website
Configuration Details
Docker Run Parameters Explained
--rm: Automatically remove container when it exits (prevents container buildup)-i: Keep STDIN open for interactive communication with MCP protocol--network host: Use host networking for seamless VS Code stdio communicationecss-mcp-server: The Docker image name built in earlier steps
Development & Contributing
Interested in contributing to this project? Please see CONTRIBUTING.md for:
- Development setup instructions
- Testing procedures
- Code guidelines
- How to submit changes
Project Structure
ecss-mcp-server/
├── src/
│ └── ecss_mcp_server/
│ ├── __init__.py
│ ├── document_parser.py # Document name formatting and file type conversion at build time
│ ├── document_reader.py # Document reading functions
│ └── ecss_mcp_server.py # FastMCP server entry - defines MCP tools
├── tests/
│ ├── conftest.py # Shared test fixtures
│ ├── test_document_parser.py
│ ├── test_document_reader.py
│ └── test_ecss_mcp_server.py
├── documents/ # Folder for ECSS .doc/.docx files (user-supplied)
├── Dockerfile # Multi-stage build with cert and system lib support
├── Makefile # Developer workflow targets (install, lint, test)
├── pyproject.toml # Dependencies and tool configuration (UV, ruff, pytest, mypy)
├── README.md # This file
├── CONTRIBUTING.md # Contribution guidelines
├── SECURITY.md # Security policy and considerations
├── CODE_OF_CONDUCT.md # Community guidelines
├── LICENSE # Apache 2.0 License
└── .github/
├── copilot-instructions.md # Copilot agent instructions
├── skills/ # Custom Copilot skill definitions
└── workflows/ # CI/CD GitHub Actions workflows
Troubleshooting
Container Issues
Container fails to start:
- Verify Docker is running:
docker --version - Check image exists:
docker images | grep ecss-mcp-server - Review build logs for errors during image creation
- Test manually:
docker run -it --name test ecss-mcp-server
VS Code Integration Issues
VS Code doesn't detect the server:
- Confirm
mcp.jsonconfiguration syntax is valid JSON - Verify file location:
%APPDATA%\Code\User\mcp.json(Windows) - Restart VS Code after configuration changes
- Check VS Code Developer Console (
Help > Toggle Developer Tools) for MCP-related errors - Ensure Docker Desktop is running before starting VS Code
Server appears but tools don't work:
- Rebuild the Docker image to ensure latest code
- Check that FastMCP banner shows on startup
- Test tools manually:
docker run -it --name test ecss-mcp-server
Technical Details
Dependencies
- Python: 3.14 (slim-trixie base image)
- FastMCP: ≥3.1.1 (MCP protocol implementation)
- python-docx: ≥1.2.0 (reading
.docxdocument content) - libreoffice: headless (converting
.docfiles to.docxat build time)
Security Considerations
For detailed security information, including vulnerability reporting, and privacy considerations, please see SECURITY.md.
Support & Resources
- FastMCP Documentation: https://gofastmcp.com
- MCP Protocol Specification: https://modelcontextprotocol.io
- Docker Documentation: https://docs.docker.com
Project Documentation
- CONTRIBUTING.md - How to contribute to this project
- SECURITY.md - Security policy and vulnerability reporting
- LICENSE - Apache 2.0 License details
- CODE_OF_CONDUCT.md - Community guidelines
Acknowledgments
- Data Source: ECSS Initiative
- Framework: FastMCP by the FastMCP team
- Protocol: Model Context Protocol (MCP) specification
Установить Ecss в Claude Desktop, Claude Code, Cursor
unyly install ecssСтавит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.
Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh
Или настроить вручную
Выполни в терминале:
claude mcp add ecss -- uvx --from git+https://github.com/aerospace-mcp-tools/ecss-mcp-server ecss-mcp-serverПошаговые гайды: как установить Ecss
FAQ
Ecss MCP бесплатный?
Да, Ecss MCP бесплатный — установка в пару кликов через Unyly без оплаты.
Нужен ли API-ключ для Ecss?
Нет, Ecss работает без API-ключей и переменных окружения.
Ecss — hosted или self-hosted?
Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.
Как установить Ecss в Claude Desktop, Claude Code или Cursor?
Открой Ecss на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.
Похожие MCP
GitHub
PRs, issues, code search, CI status
автор: GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
автор: mcpdotdirectServer Sequential Thinking
MCP server for sequential thinking and problem solving
автор: GitHub ActionsUnyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
автор: UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
автор: duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
автор: blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
автор: Mitsubishi-FusoGpt Image 2 Mcp
RunAPI GPT Image 2 MCP server for image generation: create tasks, poll results, and check pricing across 1 model from Claude Code, Codex, Cursor, and VS Code.
автор: runapi-aiCompare Ecss with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории development
