-
Notifications
You must be signed in to change notification settings - Fork 9
Bump server version to 0.6.0 #172
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
WalkthroughThe version number of the Changes
Estimated code review effort1 (~2 minutes) Possibly related PRs
✨ Finishing Touches
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. 🪧 TipsChatThere are 3 ways to chat with CodeRabbit:
SupportNeed help? Create a ticket on our support page for assistance with any issues or questions. Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments. CodeRabbit Commands (Invoked using PR comments)
Other keywords and placeholders
CodeRabbit Configuration File (
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Actionable comments posted: 0
🧹 Nitpick comments (1)
pyproject.toml (1)
3-3
: Consider updating ancillary artifacts (CHANGELOG, release notes).A version bump typically warrants an entry in
CHANGELOG.md
(or equivalent) and an updated tag/release description so downstream consumers can track what changed.
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (2)
blockscout_mcp_server/__init__.py
(1 hunks)pyproject.toml
(1 hunks)
📓 Path-based instructions (3)
pyproject.toml
📄 CodeRabbit Inference Engine (.cursor/rules/010-implementation-rules.mdc)
If any new package needs to be installed it needs to be done with 'sudo
which uv
pip install --system ""' command. Don't forget to update pyproject.toml with the new package.When updating the version of the MCP server, update the
version
field in the[project]
section ofpyproject.toml
.
Files:
pyproject.toml
**/*.py
📄 CodeRabbit Inference Engine (.cursor/rules/000-role-and-task.mdc)
**/*.py
: The MCP server must be implemented in Python, as you are a senior Python developer and the expertise is in Python.
The MCP server must wrap Blockscout APIs and expose blockchain data (balances, tokens, NFTs, contract metadata) via the Model Context Protocol (MCP).
The MCP server must communicate with AI agents/chat applications through stdin.
**/*.py
: Regular Python modules should generally not exceed 500 lines of code (LOC). If a module approaches this limit, consider splitting it into multiple focused modules (e.g., address_tools.py and address_tools_advanced.py) to maintain readability and logical organization.
ALL import statements must be placed at the top of the Python module, immediately after the module docstring (if present) and before any other code. Never insert imports inline near where the functionality is used. Follow PEP 8 import order.
ALL linting and formatting issues must be resolved before committing or pushing code. Use the Ruff rules defined in 300-ruff-lint-and-format.mdc to identify and fix issues.
**/*.py
: Always runruff check . --fix
andruff format .
on generated code before suggesting commits or opening a PR
Avoid using# noqa: E501
for ordinary code lines; split long lines instead. Only use# noqa: E501
for docstrings or string literals that must exceed 120 characters.
Use Ruff to enforce a 120-character line length, compatible with Black formatting
Files:
blockscout_mcp_server/__init__.py
blockscout_mcp_server/__init__.py
📄 CodeRabbit Inference Engine (.cursor/rules/130-version-management.mdc)
When updating the version of the MCP server, update the
__version__
variable inblockscout_mcp_server/__init__.py
.
Files:
blockscout_mcp_server/__init__.py
🧠 Learnings (3)
📓 Common learnings
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Applies to blockscout_mcp_server/__init__.py : When updating the version of the MCP server, update the `__version__` variable in `blockscout_mcp_server/__init__.py`.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Update both `pyproject.toml` and `blockscout_mcp_server/__init__.py` simultaneously to maintain consistency across the codebase.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Use the exact same version string in both `pyproject.toml` and `blockscout_mcp_server/__init__.py`.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Applies to pyproject.toml : When updating the version of the MCP server, update the `version` field in the `[project]` section of `pyproject.toml`.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/200-development-testing-workflow.mdc:0-0
Timestamp: 2025-07-22T00:13:24.809Z
Learning: Ensure your changes are well-tested by checking test coverage using pytest --cov=blockscout_mcp_server --cov-report=term-missing
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/000-role-and-task.mdc:0-0
Timestamp: 2025-07-22T00:11:07.532Z
Learning: Applies to **/*.py : The MCP server must wrap Blockscout APIs and expose blockchain data (balances, tokens, NFTs, contract metadata) via the Model Context Protocol (MCP).
Learnt from: akolotov
PR: blockscout/mcp-server#142
File: blockscout_mcp_server/api/routes.py:242-258
Timestamp: 2025-07-10T19:21:50.271Z
Learning: The user akolotov prefers a unified tool registration approach where a single function registers tools in both MCP and REST API instead of having separate registration points in blockscout_mcp_server/server.py and blockscout_mcp_server/api/routes.py. This would eliminate duplication and reduce maintenance burden.
Learnt from: akolotov
PR: blockscout/mcp-server#148
File: blockscout_mcp_server/api/routes.py:44-52
Timestamp: 2025-07-11T00:58:37.475Z
Learning: Logging is not currently used in the blockscout/mcp-server codebase. Full logging support will be implemented in a separate issue. Print statements are acceptable temporarily until proper logging is implemented.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .github/copilot-instructions.md:0-0
Timestamp: 2025-07-22T00:11:00.226Z
Learning: Read the project technical description in `SPEC.md` to clearly understand how the MCP server communicates with counterparties and important aspects of the server implementation before responding to a user request.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/tools/*.py : Do not expose individual pagination parameters (like page, offset, items_count) in tool signatures; use a single opaque cursor string.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/config.py : For paginated tools, add a dedicated page size configuration variable to blockscout_mcp_server/config.py.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/config.py : Add new API endpoint configuration to blockscout_mcp_server/config.py when introducing a new external API endpoint.
pyproject.toml (13)
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Applies to blockscout_mcp_server/init.py : When updating the version of the MCP server, update the __version__
variable in blockscout_mcp_server/__init__.py
.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Update both pyproject.toml
and blockscout_mcp_server/__init__.py
simultaneously to maintain consistency across the codebase.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Applies to pyproject.toml : When updating the version of the MCP server, update the version
field in the [project]
section of pyproject.toml
.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Use the exact same version string in both pyproject.toml
and blockscout_mcp_server/__init__.py
.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/200-development-testing-workflow.mdc:0-0
Timestamp: 2025-07-22T00:13:24.809Z
Learning: Ensure your changes are well-tested by checking test coverage using pytest --cov=blockscout_mcp_server --cov-report=term-missing
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/000-role-and-task.mdc:0-0
Timestamp: 2025-07-22T00:11:07.532Z
Learning: Applies to **/*.py : The MCP server must wrap Blockscout APIs and expose blockchain data (balances, tokens, NFTs, contract metadata) via the Model Context Protocol (MCP).
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/tools/*.py : Do not expose individual pagination parameters (like page, offset, items_count) in tool signatures; use a single opaque cursor string.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/config.py : For paginated tools, add a dedicated page size configuration variable to blockscout_mcp_server/config.py.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/config.py : Add new API endpoint configuration to blockscout_mcp_server/config.py when introducing a new external API endpoint.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/tools/*.py : When simplifying address objects in tool outputs, transform complex address objects into a single address string.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/server.py : Register each new tool in blockscout_mcp_server/server.py by importing the tool function and registering it with the MCP server using the @mcp.tool() decorator.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/000-role-and-task.mdc:0-0
Timestamp: 2025-07-22T00:11:07.532Z
Learning: Applies to **/*.py : The MCP server must be implemented in Python, as you are a senior Python developer and the expertise is in Python.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/150-rest-api-implementation.mdc:0-0
Timestamp: 2025-07-22T00:12:50.405Z
Learning: Applies to blockscout_mcp_server/api/routes.py : REST handler functions in api/routes.py MUST be named after the MCP tool they wrap, with an _rest suffix (e.g., get_block_info_rest).
blockscout_mcp_server/__init__.py (13)
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Applies to blockscout_mcp_server/init.py : When updating the version of the MCP server, update the __version__
variable in blockscout_mcp_server/__init__.py
.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Use the exact same version string in both pyproject.toml
and blockscout_mcp_server/__init__.py
.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Applies to pyproject.toml : When updating the version of the MCP server, update the version
field in the [project]
section of pyproject.toml
.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Update both pyproject.toml
and blockscout_mcp_server/__init__.py
simultaneously to maintain consistency across the codebase.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/200-development-testing-workflow.mdc:0-0
Timestamp: 2025-07-22T00:13:24.809Z
Learning: Ensure your changes are well-tested by checking test coverage using pytest --cov=blockscout_mcp_server --cov-report=term-missing
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/000-role-and-task.mdc:0-0
Timestamp: 2025-07-22T00:11:07.532Z
Learning: Applies to **/*.py : The MCP server must wrap Blockscout APIs and expose blockchain data (balances, tokens, NFTs, contract metadata) via the Model Context Protocol (MCP).
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/tools/*.py : Do not expose individual pagination parameters (like page, offset, items_count) in tool signatures; use a single opaque cursor string.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/config.py : Add new API endpoint configuration to blockscout_mcp_server/config.py when introducing a new external API endpoint.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/config.py : For paginated tools, add a dedicated page size configuration variable to blockscout_mcp_server/config.py.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/tools/*.py : When simplifying address objects in tool outputs, transform complex address objects into a single address string.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/server.py : Register each new tool in blockscout_mcp_server/server.py by importing the tool function and registering it with the MCP server using the @mcp.tool() decorator.
Learnt from: akolotov
PR: #148
File: blockscout_mcp_server/api/routes.py:44-52
Timestamp: 2025-07-11T00:58:37.475Z
Learning: Logging is not currently used in the blockscout/mcp-server codebase. Full logging support will be implemented in a separate issue. Print statements are acceptable temporarily until proper logging is implemented.
Learnt from: akolotov
PR: #145
File: .cursor/rules/800-api-documentation-guidelines.mdc:14-35
Timestamp: 2025-07-10T23:39:32.034Z
Learning: In the Blockscout MCP Server project, API documentation in API.md intentionally omits example responses because the responses from Blockscout MCP tools are very large, and including them would make the document size unmanageable.
🧰 Additional context used
📓 Path-based instructions (3)
pyproject.toml
📄 CodeRabbit Inference Engine (.cursor/rules/010-implementation-rules.mdc)
If any new package needs to be installed it needs to be done with 'sudo
which uv
pip install --system ""' command. Don't forget to update pyproject.toml with the new package.When updating the version of the MCP server, update the
version
field in the[project]
section ofpyproject.toml
.
Files:
pyproject.toml
**/*.py
📄 CodeRabbit Inference Engine (.cursor/rules/000-role-and-task.mdc)
**/*.py
: The MCP server must be implemented in Python, as you are a senior Python developer and the expertise is in Python.
The MCP server must wrap Blockscout APIs and expose blockchain data (balances, tokens, NFTs, contract metadata) via the Model Context Protocol (MCP).
The MCP server must communicate with AI agents/chat applications through stdin.
**/*.py
: Regular Python modules should generally not exceed 500 lines of code (LOC). If a module approaches this limit, consider splitting it into multiple focused modules (e.g., address_tools.py and address_tools_advanced.py) to maintain readability and logical organization.
ALL import statements must be placed at the top of the Python module, immediately after the module docstring (if present) and before any other code. Never insert imports inline near where the functionality is used. Follow PEP 8 import order.
ALL linting and formatting issues must be resolved before committing or pushing code. Use the Ruff rules defined in 300-ruff-lint-and-format.mdc to identify and fix issues.
**/*.py
: Always runruff check . --fix
andruff format .
on generated code before suggesting commits or opening a PR
Avoid using# noqa: E501
for ordinary code lines; split long lines instead. Only use# noqa: E501
for docstrings or string literals that must exceed 120 characters.
Use Ruff to enforce a 120-character line length, compatible with Black formatting
Files:
blockscout_mcp_server/__init__.py
blockscout_mcp_server/__init__.py
📄 CodeRabbit Inference Engine (.cursor/rules/130-version-management.mdc)
When updating the version of the MCP server, update the
__version__
variable inblockscout_mcp_server/__init__.py
.
Files:
blockscout_mcp_server/__init__.py
🧠 Learnings (3)
📓 Common learnings
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Applies to blockscout_mcp_server/__init__.py : When updating the version of the MCP server, update the `__version__` variable in `blockscout_mcp_server/__init__.py`.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Update both `pyproject.toml` and `blockscout_mcp_server/__init__.py` simultaneously to maintain consistency across the codebase.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Use the exact same version string in both `pyproject.toml` and `blockscout_mcp_server/__init__.py`.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Applies to pyproject.toml : When updating the version of the MCP server, update the `version` field in the `[project]` section of `pyproject.toml`.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/200-development-testing-workflow.mdc:0-0
Timestamp: 2025-07-22T00:13:24.809Z
Learning: Ensure your changes are well-tested by checking test coverage using pytest --cov=blockscout_mcp_server --cov-report=term-missing
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/000-role-and-task.mdc:0-0
Timestamp: 2025-07-22T00:11:07.532Z
Learning: Applies to **/*.py : The MCP server must wrap Blockscout APIs and expose blockchain data (balances, tokens, NFTs, contract metadata) via the Model Context Protocol (MCP).
Learnt from: akolotov
PR: blockscout/mcp-server#142
File: blockscout_mcp_server/api/routes.py:242-258
Timestamp: 2025-07-10T19:21:50.271Z
Learning: The user akolotov prefers a unified tool registration approach where a single function registers tools in both MCP and REST API instead of having separate registration points in blockscout_mcp_server/server.py and blockscout_mcp_server/api/routes.py. This would eliminate duplication and reduce maintenance burden.
Learnt from: akolotov
PR: blockscout/mcp-server#148
File: blockscout_mcp_server/api/routes.py:44-52
Timestamp: 2025-07-11T00:58:37.475Z
Learning: Logging is not currently used in the blockscout/mcp-server codebase. Full logging support will be implemented in a separate issue. Print statements are acceptable temporarily until proper logging is implemented.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .github/copilot-instructions.md:0-0
Timestamp: 2025-07-22T00:11:00.226Z
Learning: Read the project technical description in `SPEC.md` to clearly understand how the MCP server communicates with counterparties and important aspects of the server implementation before responding to a user request.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/tools/*.py : Do not expose individual pagination parameters (like page, offset, items_count) in tool signatures; use a single opaque cursor string.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/config.py : For paginated tools, add a dedicated page size configuration variable to blockscout_mcp_server/config.py.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/config.py : Add new API endpoint configuration to blockscout_mcp_server/config.py when introducing a new external API endpoint.
pyproject.toml (13)
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Applies to blockscout_mcp_server/init.py : When updating the version of the MCP server, update the __version__
variable in blockscout_mcp_server/__init__.py
.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Update both pyproject.toml
and blockscout_mcp_server/__init__.py
simultaneously to maintain consistency across the codebase.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Applies to pyproject.toml : When updating the version of the MCP server, update the version
field in the [project]
section of pyproject.toml
.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Use the exact same version string in both pyproject.toml
and blockscout_mcp_server/__init__.py
.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/200-development-testing-workflow.mdc:0-0
Timestamp: 2025-07-22T00:13:24.809Z
Learning: Ensure your changes are well-tested by checking test coverage using pytest --cov=blockscout_mcp_server --cov-report=term-missing
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/000-role-and-task.mdc:0-0
Timestamp: 2025-07-22T00:11:07.532Z
Learning: Applies to **/*.py : The MCP server must wrap Blockscout APIs and expose blockchain data (balances, tokens, NFTs, contract metadata) via the Model Context Protocol (MCP).
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/tools/*.py : Do not expose individual pagination parameters (like page, offset, items_count) in tool signatures; use a single opaque cursor string.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/config.py : For paginated tools, add a dedicated page size configuration variable to blockscout_mcp_server/config.py.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/config.py : Add new API endpoint configuration to blockscout_mcp_server/config.py when introducing a new external API endpoint.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/tools/*.py : When simplifying address objects in tool outputs, transform complex address objects into a single address string.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/server.py : Register each new tool in blockscout_mcp_server/server.py by importing the tool function and registering it with the MCP server using the @mcp.tool() decorator.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/000-role-and-task.mdc:0-0
Timestamp: 2025-07-22T00:11:07.532Z
Learning: Applies to **/*.py : The MCP server must be implemented in Python, as you are a senior Python developer and the expertise is in Python.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/150-rest-api-implementation.mdc:0-0
Timestamp: 2025-07-22T00:12:50.405Z
Learning: Applies to blockscout_mcp_server/api/routes.py : REST handler functions in api/routes.py MUST be named after the MCP tool they wrap, with an _rest suffix (e.g., get_block_info_rest).
blockscout_mcp_server/__init__.py (13)
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Applies to blockscout_mcp_server/init.py : When updating the version of the MCP server, update the __version__
variable in blockscout_mcp_server/__init__.py
.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Use the exact same version string in both pyproject.toml
and blockscout_mcp_server/__init__.py
.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Applies to pyproject.toml : When updating the version of the MCP server, update the version
field in the [project]
section of pyproject.toml
.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/130-version-management.mdc:0-0
Timestamp: 2025-07-22T00:12:19.662Z
Learning: Update both pyproject.toml
and blockscout_mcp_server/__init__.py
simultaneously to maintain consistency across the codebase.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/200-development-testing-workflow.mdc:0-0
Timestamp: 2025-07-22T00:13:24.809Z
Learning: Ensure your changes are well-tested by checking test coverage using pytest --cov=blockscout_mcp_server --cov-report=term-missing
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/000-role-and-task.mdc:0-0
Timestamp: 2025-07-22T00:11:07.532Z
Learning: Applies to **/*.py : The MCP server must wrap Blockscout APIs and expose blockchain data (balances, tokens, NFTs, contract metadata) via the Model Context Protocol (MCP).
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/tools/*.py : Do not expose individual pagination parameters (like page, offset, items_count) in tool signatures; use a single opaque cursor string.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/config.py : Add new API endpoint configuration to blockscout_mcp_server/config.py when introducing a new external API endpoint.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/config.py : For paginated tools, add a dedicated page size configuration variable to blockscout_mcp_server/config.py.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/tools/*.py : When simplifying address objects in tool outputs, transform complex address objects into a single address string.
Learnt from: CR
PR: blockscout/mcp-server#0
File: .cursor/rules/110-new-mcp-tool.mdc:0-0
Timestamp: 2025-07-22T00:12:06.026Z
Learning: Applies to blockscout_mcp_server/server.py : Register each new tool in blockscout_mcp_server/server.py by importing the tool function and registering it with the MCP server using the @mcp.tool() decorator.
Learnt from: akolotov
PR: #148
File: blockscout_mcp_server/api/routes.py:44-52
Timestamp: 2025-07-11T00:58:37.475Z
Learning: Logging is not currently used in the blockscout/mcp-server codebase. Full logging support will be implemented in a separate issue. Print statements are acceptable temporarily until proper logging is implemented.
Learnt from: akolotov
PR: #145
File: .cursor/rules/800-api-documentation-guidelines.mdc:14-35
Timestamp: 2025-07-10T23:39:32.034Z
Learning: In the Blockscout MCP Server project, API documentation in API.md intentionally omits example responses because the responses from Blockscout MCP tools are very large, and including them would make the document size unmanageable.
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
- GitHub Check: Docker build and docker push
🔇 Additional comments (2)
pyproject.toml (1)
3-3
: Version bump is correct and consistent.
version = "0.6.0"
matches the bump inblockscout_mcp_server/__init__.py
.
No further issues spotted.blockscout_mcp_server/__init__.py (1)
3-3
:__version__
updated — looks good.The string matches the value in
pyproject.toml
; nothing else to address.
Summary
pyproject.toml
and__init__.py
Testing
ruff check . --fix
ruff format .
ruff check .
ruff format --check .
pytest -q
https://chatgpt.com/codex/tasks/task_b_68802346a7ac83238a79faab39220c5d
Summary by CodeRabbit