The MCP server is distributed through PyPI as the bach-cedar-mcp package, allowing easy installation and deployment via pip or uvx
CEDAR MCP Server
A Model Context Protocol (MCP) server for interacting with the CEDAR (Center for Expanded Data Annotation and Retrieval) metadata repository.
🚀 快速启动(推荐)
使用 UVX 一键启动
在 Cursor/Cherry Studio 中配置
PyPI 包地址: https://pypi.org/project/bach-cedar-mcp/
Prerequisites
Before using this MCP server, you'll need API keys from:
CEDAR API Key
Go to cedar.metadatacenter.org
Create an account or log in
Navigate to: Profile → API Key
Copy your API key
BioPortal API Key
Create an account or log in
Navigate to: Account Settings → API Key
Copy your API key
Running the CEDAR MCP Server
Option 1: Using UVX from PyPI (Recommended)
Run directly without installation using uvx
:
Option 2: Install from PyPI
Install using pip and run:
Option 3: Using Environment Variables
Set environment variables instead of command-line arguments:
Option 4: Local Development
Clone and run from source:
Using with Claude Code
Add the CEDAR MCP server to Claude Code:
Using with Claude Desktop
To use with Claude Desktop app:
Install the MCP server using one of the methods above
Add to Claude Desktop configuration in your
claude_desktop_config.json
:
Or if you have it installed with pip:
Available Tools
Here is the list of CEDAR tools with a short description
get_template
: Fetches a template from the CEDAR repository.get_instances_based_on_template
: Gets template instances that belong to a specific template with pagination support.
Development
Install Development Dependencies
Running Tests
This project includes comprehensive integration tests that validate real API interactions with both CEDAR and BioPortal APIs.
For detailed testing information, see test/README.md.
Contributing
Contributions are welcome! Please ensure all tests pass before submitting a Pull Request:
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables interaction with the CEDAR (Center for Expanded Data Annotation and Retrieval) metadata repository to fetch templates and retrieve template instances. Supports querying structured metadata and biomedical data annotations through the CEDAR platform.