Currents MCP Server
This is a MCP server that allows you to provide test results context to your AI agents by connecting them to Currents. Useful for asking AI to fix or optimize tests failing in CI.
Tools
get-api-config
- Get the API key and URL used to make requests to Currents API
get-run
- Get the run information by its ID
get-spec-file-attempts-and-errors
- Get the instance information about attempts and errors by its ID
Setup
API Key
Get a Currents API key by following the instructions here.
Usage with Cursor Editor
- Go to Cursor Settings > MCP > Enable
- Add the following to your
mcp.json
.
NPX
Usage with Claude Desktop
Installing via Smithery
To install Currents Test Results Context Server for Claude Desktop automatically via Smithery:
Add the following to your claude_desktop_config.json
:
NPX
⚠️ Notice
By connecting AI tools (e.g., via MCP) to Currents, you are granting them access to your API key, test results and CI metadata. It is your responsibility to vet any AI agents or services you use, and to ensure they handle your data securely.
How to Contribute
We welcome contributions of all kinds—bug fixes, features, and documentation updates!
Quick Start
- Fork this repository and clone your fork:
- Install dependencies:
- Build the project:
- Run locally (stdio):You should see:
Currents MCP Server running on stdio
.
Local Development with a Client (optional)
To test with a local MCP client (e.g., Cursor or Claude Desktop), point the client to your built server:
- Command:
node
- Args:
./mcp-server/build/index.js
- Env: set
CURRENTS_API_KEY
to a valid key
Example snippet for a client config:
Making Changes
- Create a feature branch:
- Make changes under
mcp-server/src/
, then rebuild and re-run: - Keep changes focused and documented (add comments/types where helpful).
Commit and PR Guidelines
- Write clear commit messages (e.g., “fix: handle missing env vars” or “feat: add get-run tool filters”).
- Push your branch and open a Pull Request:
- In your PR, describe the motivation, approach, and any trade-offs. Link related issues if applicable.
Reporting Issues
- Before creating a new issue, please search existing issues to avoid duplicates.
- When filing a bug report, include steps to reproduce, expected vs. actual behavior, and environment details (OS, Node.js version).
License
By contributing, you agree that your contributions will be licensed under the ISC license (as specified in the package metadata).
This server cannot be installed
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.
Currents
Related MCP Servers
- PythonMIT License
- TypeScriptApache 2.0
- Python
- Go