| Name | cortellis-mcp JSON |
| Version |
0.1.0
JSON |
| download |
| home_page | None |
| Summary | Cortellis MCP Server for drug search and ontology exploration |
| upload_time | 2025-03-22 02:04:44 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | MIT License
Copyright (c) 2025 Cortellis MCP Server Contributors
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE. |
| keywords |
cortellis
drug-search
mcp
ontology
pharmaceutical
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Cortellis MCP Server
<!-- Project Status -->
[](https://opensource.org/licenses/MIT)
[](https://github.com/uh-joan/mcp-cortellis)
[](https://github.com/uh-joan/mcp-cortellis/tree/main/docs)
[](https://github.com/uh-joan/mcp-cortellis)
<!-- Package Info -->
[](https://pypi.org/project/cortellis-mcp/)
[](https://pypi.org/project/cortellis-mcp/)
[](https://pypi.org/project/cortellis-mcp/)
[](https://pypi.org/project/cortellis-mcp/)
<!-- Technology Stack -->
[](https://www.python.org/downloads/)
[](https://github.com/uh-joan/mcp-cortellis/blob/main/Dockerfile)
[](https://github.com/astral-sh/ruff)
<!-- Platform Support -->
[](https://github.com/uh-joan/mcp-cortellis)
[](https://github.com/uh-joan/mcp-cortellis)
<!-- Repository Activity -->
[](https://github.com/uh-joan/mcp-cortellis/stargazers)
[](https://github.com/uh-joan/mcp-cortellis/commits/main)
[](https://github.com/uh-joan/mcp-cortellis/issues)
[](https://github.com/uh-joan/mcp-cortellis/pulls)
[](CONTRIBUTING.md)
A production-ready MCP server enabling AI assistants to search and analyze pharmaceutical data through Cortellis. Features comprehensive drug search, ontology exploration, and real-time clinical trial data access.
Perfect for drug discovery, clinical trial analysis, and pharmaceutical market research, this server enables natural language interactions for complex pharmaceutical queries.
## Features
- 🔍 **Comprehensive Drug Search**
- Search by indication, phase, company, and more
- Real-time access to drug development statuses
- Detailed pharmaceutical data retrieval
- 🧬 **Ontology Exploration**
- Explore standardized medical terminology
- Navigate drug classifications
- Discover relationships between terms
- 🔐 **Secure Authentication**
- Environment-based credential management
- Secure API communication
- Rate limiting and request validation
- 🛠 **Developer-Friendly**
- Clear API documentation
- Example scripts and use cases
- Easy integration with AI assistants
## Architecture
```mermaid
graph LR
A[AI Assistant] --> B[MCP Server]
B --> C[Cortellis API]
C --> D[Drug Data]
C --> E[Ontology Data]
B --> F[Response Processing]
F --> A
```
## Prerequisites
- Python 3.10 or higher
- uv package manager (recommended) or pip
- Cortellis API credentials
## Installation
### From PyPI (Recommended)
```bash
# Using pip
pip install cortellis-mcp
# Using uv
uv pip install cortellis-mcp
```
### Local Installation (Development)
1. Clone the repository:
```bash
git clone https://github.com/uh-joan/mcp-cortellis.git
cd mcp-cortellis
```
2. Install the package:
```bash
# Using uv (recommended)
uv venv
source .venv/bin/activate # On Unix/macOS
# or
.venv\Scripts\activate # On Windows
uv pip install -e .
# Or using pip
python -m venv .venv
source .venv/bin/activate # On Unix/macOS
# or
.venv\Scripts\activate # On Windows
pip install -e .
```
3. Set up your environment variables:
```bash
# In your .env file
CORTELLIS_USERNAME=your_username
CORTELLIS_PASSWORD=your_password
```
### Alternative: Install from GitHub
If you just want to use the package without development:
```bash
# Using uv
uv pip install git+https://github.com/uh-joan/mcp-cortellis.git
# Or using pip
pip install git+https://github.com/uh-joan/mcp-cortellis.git
```
## Using with Cursor IDE
Add the following to your `.cursor/settings.json`:
```json
{
"mcps": {
"cortellis": {
"command": ["python", "-m", "cortellis_mcp"],
"env": {
"CORTELLIS_USERNAME": "your_username",
"CORTELLIS_PASSWORD": "your_password"
}
}
}
}
```
After restarting Cursor, you can use natural language prompts like:
- "Search for drugs targeting obesity in phase 3"
- "Find all launched drugs by Novo Nordisk"
- "Explore ontology terms related to glucagon"
## Quick Start
```python
from cortellis_mcp import search_drugs, explore_ontology
# Search for Phase 3 obesity drugs
results = search_drugs(
indication="obesity",
phase="C3" # Phase 3 Clinical
)
# Explore ontology terms
terms = explore_ontology(
category="indication",
term="diabetes"
)
```
Check the [examples](examples/) directory for more usage examples.
## API Reference
See the [API documentation](docs/API.md) for detailed function references.
### Development Status Codes
When searching for drugs, you can use these phase codes:
- `S`: Suspended
- `DR`: Discovery/Preclinical
- `CU`: Clinical (unknown phase)
- `C1`: Phase 1 Clinical
- `C2`: Phase 2 Clinical
- `C3`: Phase 3 Clinical
- `PR`: Pre-registration
- `R`: Registered
- `L`: Launched
- `OL`: Outlicensed
- `NDR`: No Development Reported
- `DX`: Discontinued
- `W`: Withdrawn
## Development
For development work, follow the [Local Installation](#local-installation-recommended) instructions above, which will install the package in editable mode (`-e` flag).
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Security Considerations
- API credentials are stored securely in environment variables
- All requests are authenticated and validated
- Rate limiting is enforced to prevent abuse
- HTTPS encryption for all API communications
- Regular security audits and updates
## Categories
- Research & Data
- Health & Wellness
- Developer Tools
- API Integration
## Contributing
Contributions are welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md) before submitting changes.
## Support
- 📚 [Documentation](docs/API.md)
- 💬 [GitHub Issues](https://github.com/uh-joan/mcp-cortellis/issues)
- 📧 [Email Support](mailto:janisaez@gmail.com)
Raw data
{
"_id": null,
"home_page": null,
"name": "cortellis-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "cortellis, drug-search, mcp, ontology, pharmaceutical",
"author": null,
"author_email": "Joan <janisaez@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/15/2c/46e867de1fdf1719268a076882b0624eb3192466b969888b481907b1a662/cortellis_mcp-0.1.0.tar.gz",
"platform": null,
"description": "# Cortellis MCP Server\n\n<!-- Project Status -->\n[](https://opensource.org/licenses/MIT)\n[](https://github.com/uh-joan/mcp-cortellis)\n[](https://github.com/uh-joan/mcp-cortellis/tree/main/docs)\n[](https://github.com/uh-joan/mcp-cortellis)\n\n<!-- Package Info -->\n[](https://pypi.org/project/cortellis-mcp/)\n[](https://pypi.org/project/cortellis-mcp/)\n[](https://pypi.org/project/cortellis-mcp/)\n[](https://pypi.org/project/cortellis-mcp/)\n\n<!-- Technology Stack -->\n[](https://www.python.org/downloads/)\n[](https://github.com/uh-joan/mcp-cortellis/blob/main/Dockerfile)\n[](https://github.com/astral-sh/ruff)\n\n<!-- Platform Support -->\n[](https://github.com/uh-joan/mcp-cortellis)\n[](https://github.com/uh-joan/mcp-cortellis)\n\n<!-- Repository Activity -->\n[](https://github.com/uh-joan/mcp-cortellis/stargazers)\n[](https://github.com/uh-joan/mcp-cortellis/commits/main)\n[](https://github.com/uh-joan/mcp-cortellis/issues)\n[](https://github.com/uh-joan/mcp-cortellis/pulls)\n[](CONTRIBUTING.md)\n\nA production-ready MCP server enabling AI assistants to search and analyze pharmaceutical data through Cortellis. Features comprehensive drug search, ontology exploration, and real-time clinical trial data access.\n\nPerfect for drug discovery, clinical trial analysis, and pharmaceutical market research, this server enables natural language interactions for complex pharmaceutical queries.\n\n## Features\n\n- \ud83d\udd0d **Comprehensive Drug Search**\n - Search by indication, phase, company, and more\n - Real-time access to drug development statuses\n - Detailed pharmaceutical data retrieval\n\n- \ud83e\uddec **Ontology Exploration**\n - Explore standardized medical terminology\n - Navigate drug classifications\n - Discover relationships between terms\n\n- \ud83d\udd10 **Secure Authentication**\n - Environment-based credential management\n - Secure API communication\n - Rate limiting and request validation\n\n- \ud83d\udee0 **Developer-Friendly**\n - Clear API documentation\n - Example scripts and use cases\n - Easy integration with AI assistants\n\n## Architecture\n\n```mermaid\ngraph LR\n A[AI Assistant] --> B[MCP Server]\n B --> C[Cortellis API]\n C --> D[Drug Data]\n C --> E[Ontology Data]\n B --> F[Response Processing]\n F --> A\n```\n\n## Prerequisites\n\n- Python 3.10 or higher\n- uv package manager (recommended) or pip\n- Cortellis API credentials\n\n## Installation\n\n### From PyPI (Recommended)\n\n```bash\n# Using pip\npip install cortellis-mcp\n\n# Using uv\nuv pip install cortellis-mcp\n```\n\n### Local Installation (Development)\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/uh-joan/mcp-cortellis.git\ncd mcp-cortellis\n```\n\n2. Install the package:\n```bash\n# Using uv (recommended)\nuv venv\nsource .venv/bin/activate # On Unix/macOS\n# or\n.venv\\Scripts\\activate # On Windows\nuv pip install -e .\n\n# Or using pip\npython -m venv .venv\nsource .venv/bin/activate # On Unix/macOS\n# or\n.venv\\Scripts\\activate # On Windows\npip install -e .\n```\n\n3. Set up your environment variables:\n```bash\n# In your .env file\nCORTELLIS_USERNAME=your_username\nCORTELLIS_PASSWORD=your_password\n```\n\n### Alternative: Install from GitHub\n\nIf you just want to use the package without development:\n\n```bash\n# Using uv\nuv pip install git+https://github.com/uh-joan/mcp-cortellis.git\n\n# Or using pip\npip install git+https://github.com/uh-joan/mcp-cortellis.git\n```\n\n## Using with Cursor IDE\n\nAdd the following to your `.cursor/settings.json`:\n```json\n{\n \"mcps\": {\n \"cortellis\": {\n \"command\": [\"python\", \"-m\", \"cortellis_mcp\"],\n \"env\": {\n \"CORTELLIS_USERNAME\": \"your_username\",\n \"CORTELLIS_PASSWORD\": \"your_password\"\n }\n }\n }\n}\n```\n\nAfter restarting Cursor, you can use natural language prompts like:\n- \"Search for drugs targeting obesity in phase 3\"\n- \"Find all launched drugs by Novo Nordisk\"\n- \"Explore ontology terms related to glucagon\"\n\n## Quick Start\n\n```python\nfrom cortellis_mcp import search_drugs, explore_ontology\n\n# Search for Phase 3 obesity drugs\nresults = search_drugs(\n indication=\"obesity\",\n phase=\"C3\" # Phase 3 Clinical\n)\n\n# Explore ontology terms\nterms = explore_ontology(\n category=\"indication\",\n term=\"diabetes\"\n)\n```\n\nCheck the [examples](examples/) directory for more usage examples.\n\n## API Reference\n\nSee the [API documentation](docs/API.md) for detailed function references.\n\n### Development Status Codes\n\nWhen searching for drugs, you can use these phase codes:\n- `S`: Suspended\n- `DR`: Discovery/Preclinical\n- `CU`: Clinical (unknown phase)\n- `C1`: Phase 1 Clinical\n- `C2`: Phase 2 Clinical\n- `C3`: Phase 3 Clinical\n- `PR`: Pre-registration\n- `R`: Registered\n- `L`: Launched\n- `OL`: Outlicensed\n- `NDR`: No Development Reported\n- `DX`: Discontinued\n- `W`: Withdrawn\n\n## Development\n\nFor development work, follow the [Local Installation](#local-installation-recommended) instructions above, which will install the package in editable mode (`-e` flag).\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Security Considerations\n\n- API credentials are stored securely in environment variables\n- All requests are authenticated and validated\n- Rate limiting is enforced to prevent abuse\n- HTTPS encryption for all API communications\n- Regular security audits and updates\n\n## Categories\n\n- Research & Data\n- Health & Wellness\n- Developer Tools\n- API Integration\n\n## Contributing\n\nContributions are welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md) before submitting changes.\n\n## Support\n\n- \ud83d\udcda [Documentation](docs/API.md)\n- \ud83d\udcac [GitHub Issues](https://github.com/uh-joan/mcp-cortellis/issues)\n- \ud83d\udce7 [Email Support](mailto:janisaez@gmail.com)",
"bugtrack_url": null,
"license": "MIT License\n \n Copyright (c) 2025 Cortellis MCP Server Contributors\n \n Permission is hereby granted, free of charge, to any person obtaining a copy\n of this software and associated documentation files (the \"Software\"), to deal\n in the Software without restriction, including without limitation the rights\n to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n copies of the Software, and to permit persons to whom the Software is\n furnished to do so, subject to the following conditions:\n \n The above copyright notice and this permission notice shall be included in all\n copies or substantial portions of the Software.\n \n THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n SOFTWARE. ",
"summary": "Cortellis MCP Server for drug search and ontology exploration",
"version": "0.1.0",
"project_urls": {
"Bug Tracker": "https://github.com/uh-joan/mcp-cortellis/issues",
"Documentation": "https://github.com/uh-joan/mcp-cortellis/tree/main/docs",
"Homepage": "https://github.com/uh-joan/mcp-cortellis",
"Repository": "https://github.com/uh-joan/mcp-cortellis.git"
},
"split_keywords": [
"cortellis",
" drug-search",
" mcp",
" ontology",
" pharmaceutical"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "55f2856a1eadcd3fac2d604b61c35a2dc1601a2a08c3106ac207665e19654459",
"md5": "0b99db9b5d4a902d9a22d2d5493c4955",
"sha256": "eaeeec56d40fdcaf8fba9ed6944bce5f434411aecd2f0e5b46caccfc165dfb20"
},
"downloads": -1,
"filename": "cortellis_mcp-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0b99db9b5d4a902d9a22d2d5493c4955",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 8379,
"upload_time": "2025-03-22T02:04:42",
"upload_time_iso_8601": "2025-03-22T02:04:42.648841Z",
"url": "https://files.pythonhosted.org/packages/55/f2/856a1eadcd3fac2d604b61c35a2dc1601a2a08c3106ac207665e19654459/cortellis_mcp-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "152c46e867de1fdf1719268a076882b0624eb3192466b969888b481907b1a662",
"md5": "8cd6cf41a8f07a13e6985c98286a8316",
"sha256": "5886c5ffd5956d4e323cffce2460eb4c60671bb83a3a8e68f9030048f22774fe"
},
"downloads": -1,
"filename": "cortellis_mcp-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "8cd6cf41a8f07a13e6985c98286a8316",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 10242,
"upload_time": "2025-03-22T02:04:44",
"upload_time_iso_8601": "2025-03-22T02:04:44.186741Z",
"url": "https://files.pythonhosted.org/packages/15/2c/46e867de1fdf1719268a076882b0624eb3192466b969888b481907b1a662/cortellis_mcp-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-03-22 02:04:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "uh-joan",
"github_project": "mcp-cortellis",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cortellis-mcp"
}
