Mallory MCP Server
Mallory provides a robust source of cyber and threat intelligence. Use this MCP Server to enable your agents with real-time cyber threat intelligence and detailed information about vulnerabilities, threat actors, malware, techniques and other cyber-relevant entities and content.
📋 Prerequisites
- Python 3.13 or higher
- uv for dependency management (recommended)
🚀 Quick Start
Installation
Clone the repository:
git clone https://github.com/malloryai/mallory-mcp-server.git
cd mallory-mcp-server
Set up a virtual environment and install dependencies:
# Using uv (recommended)
uv venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv pip install -e .
# Or using pip
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
pip install -e .
Install Development Dependencies
For development work, install the optional dependencies:
# Using uv
uv pip install -e ".[lint,tools]"
# Or using pip
pip install -e ".[lint,tools]"
Set Up Pre-commit Hooks
This project uses pre-commit hooks to ensure code quality. Install them with:
pre-commit install
./scripts/install-commit-hook.sh
⚙️ Configuration
Create a .env file in the project root with the following variables:
APP_ENV=local
MALLORY_API_KEY=your_api_key_here
🏃♂️ Running the Server
Direct Execution
python -m malloryai.mcp.app
or
uv run malloryai/mcp/app.py
Via the Claude Desktop Configuration
Add the following to your claude_desktop_config.json:
{
"mcpServers": {
"MalloryAI": {
"command": "/path/to/uv",
"args": [
"run",
"--python",
"/path/to/mcp-server/.venv/bin/python",
"/path/to/mcp-server/malloryai/mcp/app.py"
],
"env": {
"MALLORY_API_KEY": "your_api_key_here"
}
}
}
}
📦 Project Structure
.
├── README.md
├── app.py # Main application entry point
├── malloryai/ # Main package
│ ├── __init__.py
│ └── mcp/ # MCP subpackage
│ ├── __init__.py
│ ├── config/ # Configuration modules
│ ├── server/ # Server implementation
│ ├── tools/ # Tool implementations
│ └── utils/ # Utility functions
├── pyproject.toml # Project metadata and dependencies
├── scripts/ # Utility scripts
│ └── install-commit-hook.sh
🧪 Development
Code Style
This project uses:
Format your code with:
black .
isort .
flake8
Commit Message Format
This project follows the conventional commit format. Each commit message should follow this pattern:
<type>[(scope)]: <description>
Where type is one of:
featorfeature: New featurefix,bugfix, orhotfix: Bug fixeschore: Regular maintenance tasksrefactor: Code changes that neither fix bugs nor add featuresdocs: Documentation only changesstyle: Changes that don't affect the meaning of the codetest: Adding or correcting testsperf: Performance improvementsci: Changes to CI configurationbuild: Changes to build system or dependenciesrevert: Reverting previous commits
Example: feat(server): add new authentication method
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'feat: add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Metadata
Release files for iflow-mcp_malloryai_mallory-mcp-server 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_malloryai_mallory_mcp_server-0.1.0.tar.gz | 5.1 kB | Without provenance | Details for iflow_mcp_malloryai_mallory_mcp_server-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_malloryai_mallory_mcp_server-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_malloryai_mallory_mcp_server-0.1.0-py3-none-any.whl |
Total release size: 10.3 kB
Release files / iflow_mcp_malloryai_mallory_mcp_server-0.1.0.tar.gz
| Download URL | iflow_mcp_malloryai_mallory_mcp_server-0.1.0.tar.gz |
|---|---|
| Size | 5.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f6b144605ba0ac752de28be005559755b9fbf4da190d396d054affa7897743d6
|
|
BLAKE2b-256 checksum How to use checksums |
7a6682780265cebc08c3a2687d5b9b17f7a1270aa688b4ca36c1fdf8ec22f79a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.8
|
Release files / iflow_mcp_malloryai_mallory_mcp_server-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_malloryai_mallory_mcp_server-0.1.0-py3-none-any.whl |
|---|---|
| Size | 5.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
92192ec8f8f91a2b86bb028566f0c5dd6fa1f1ced8af529d8b6a5dba7419423f
|
|
BLAKE2b-256 checksum How to use checksums |
d7415020e90344963e0d88878b6824464e6387b5ba08b34f230d10d90c927e2c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.8
|
Security for iflow-mcp_malloryai_mallory-mcp-server 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.