feat: forc mcp server - with forc-call tool integration

.github/workflows/ci.yml

@@ -49,6 +49,7 @@ jobs:
       - cargo-run-e2e-test-release
       - cargo-test-forc-debug
       - cargo-test-forc-client
+      - cargo-test-forc-mcp
       - cargo-test-forc-node
       - notify-slack-on-failure
     runs-on: ubuntu-latest
@@ -667,6 +668,27 @@ jobs:
           mv fuel-core-${{ needs.get-fuel-core-version.outputs.fuel_core_version }}-x86_64-unknown-linux-gnu/fuel-core /usr/local/bin/fuel-core
       - name: Run tests
         run: cargo test --locked --release -p forc-client -- --test-threads 1
+  cargo-test-forc-mcp:
+    runs-on: buildjet-4vcpu-ubuntu-2204
+    needs: get-fuel-core-version
+    steps:
+      - uses: actions/checkout@v3
+      - name: Install toolchain
+        uses: dtolnay/rust-toolchain@master
+        with:
+          toolchain: ${{ env.RUST_VERSION }}
+          targets: "x86_64-unknown-linux-gnu, wasm32-unknown-unknown"
+      - uses: Swatinem/rust-cache@v2
+        with:
+          cache-provider: "buildjet"
+      - name: Install fuel-core for tests
+        run: |
+          curl -sSLf https://github.com/FuelLabs/fuel-core/releases/download/v${{ needs.get-fuel-core-version.outputs.fuel_core_version }}/fuel-core-${{ needs.get-fuel-core-version.outputs.fuel_core_version }}-x86_64-unknown-linux-gnu.tar.gz -L -o fuel-core.tar.gz
+          tar -xvf fuel-core.tar.gz
+          chmod +x fuel-core-${{ needs.get-fuel-core-version.outputs.fuel_core_version }}-x86_64-unknown-linux-gnu/fuel-core
+          mv fuel-core-${{ needs.get-fuel-core-version.outputs.fuel_core_version }}-x86_64-unknown-linux-gnu/fuel-core /usr/local/bin/fuel-core
+      - name: Run tests
+        run: cargo test --locked --release -p forc-mcp -- --test-threads 1
   cargo-test-forc-node:
     runs-on: buildjet-4vcpu-ubuntu-2204
     needs: get-fuel-core-version
@@ -729,7 +751,7 @@ jobs:
         with:
           cache-provider: "buildjet"
       - name: Run tests
-        run: cargo test --locked --release --workspace --exclude forc-debug --exclude sway-lsp --exclude forc-client --exclude forc --exclude forc-node
+        run: cargo test --locked --release --workspace --exclude forc-debug --exclude sway-lsp --exclude forc-client --exclude forc-mcp --exclude forc --exclude forc-node
   cargo-unused-deps-check:
     runs-on: buildjet-4vcpu-ubuntu-2204
     steps:
@@ -948,13 +970,13 @@ jobs:
       - name: Strip release binaries x86_64-linux-gnu
         if: matrix.job.target == 'x86_64-unknown-linux-gnu'
         run: |
-          for BINARY in forc forc-fmt forc-lsp forc-debug forc-deploy forc-run forc-doc forc-crypto forc-tx forc-submit forc-migrate forc-node forc-publish forc-call; do
+          for BINARY in forc forc-fmt forc-lsp forc-debug forc-deploy forc-run forc-doc forc-crypto forc-tx forc-submit forc-mcp forc-migrate forc-node forc-publish forc-call; do
             strip "target/${{ matrix.job.target }}/release/$BINARY"
           done
       - name: Strip release binaries aarch64-linux-gnu
         if: matrix.job.target == 'aarch64-unknown-linux-gnu'
         run: |
-          for BINARY in forc forc-fmt forc-lsp forc-debug forc-deploy forc-run forc-doc forc-crypto forc-tx forc-submit forc-migrate forc-node forc-publish forc-call; do
+          for BINARY in forc forc-fmt forc-lsp forc-debug forc-deploy forc-run forc-doc forc-crypto forc-tx forc-submit forc-mcp forc-migrate forc-node forc-publish forc-call; do
             docker run --rm -v \
             "$PWD/target:/target:Z" \
             ghcr.io/cross-rs/${{ matrix.job.target }}:main \
@@ -964,7 +986,7 @@ jobs:
       - name: Strip release binaries mac
         if: matrix.job.os == 'macos-latest'
         run: |
-          for BINARY in forc forc-fmt forc-lsp forc-debug forc-deploy forc-run forc-doc forc-crypto forc-tx forc-submit forc-migrate forc-node forc-publish forc-call; do
+          for BINARY in forc forc-fmt forc-lsp forc-debug forc-deploy forc-run forc-doc forc-crypto forc-tx forc-submit forc-mcp forc-migrate forc-node forc-publish forc-call; do
             strip -x "target/${{ matrix.job.target }}/release/$BINARY"
           done
 
@@ -978,7 +1000,7 @@ jobs:
           ZIP_FILE_NAME=forc-binaries-${{ env.PLATFORM_NAME }}_${{ env.ARCH }}.tar.gz
           echo "ZIP_FILE_NAME=$ZIP_FILE_NAME" >> $GITHUB_ENV
           mkdir -pv ./forc-binaries
-          for BINARY in forc forc-fmt forc-lsp forc-debug forc-deploy forc-run forc-doc forc-crypto forc-tx forc-submit forc-migrate forc-node forc-publish forc-call; do
+          for BINARY in forc forc-fmt forc-lsp forc-debug forc-deploy forc-run forc-doc forc-crypto forc-tx forc-submit forc-mcp forc-migrate forc-node forc-publish forc-call; do
             cp "target/${{ matrix.job.target }}/release/$BINARY" ./forc-binaries
           done
           tar -czvf $ZIP_FILE_NAME ./forc-binaries

.github/workflows/gh-pages.yml

@@ -31,6 +31,7 @@ jobs:
           cargo install --locked --debug --path ./forc-plugins/forc-fmt
           cargo install --locked --debug --path ./forc-plugins/forc-doc
           cargo install --locked --debug --path ./forc-plugins/forc-lsp
+          cargo install --locked --debug --path ./forc-plugins/forc-mcp
           cargo install --locked --debug --path ./forc-plugins/forc-migrate
           cargo install --locked --debug --path ./forc-plugins/forc-node
           cargo install --locked --debug --path ./forc-plugins/forc-publish

Cargo.toml

@@ -50,6 +50,7 @@ forc-debug = { path = "forc-plugins/forc-debug/", version = "0.69.1" }
 forc-doc = { path = "forc-plugins/forc-doc/", version = "0.69.1" }
 forc-fmt = { path = "forc-plugins/forc-fmt/", version = "0.69.1" }
 forc-lsp = { path = "forc-plugins/forc-lsp/", version = "0.69.1" }
+forc-mcp = { path = "forc-plugins/forc-mcp/", version = "0.69.1" }
 forc-migrate = { path = "forc-plugins/forc-migrate/", version = "0.69.1" }
 forc-publish = { path = "forc-plugins/forc-publish/", version = "0.69.1" }
 forc-tx = { path = "forc-plugins/forc-tx/", version = "0.69.1" }
@@ -112,6 +113,7 @@ assert_matches = "1.5"
 async-trait = "0.1"
 aws-config = "1.5"
 aws-sdk-kms = "1.44"
+axum = "0.8"
 byte-unit = "5.1"
 bytes = "1.7"
 chrono = { version = "0.4", default-features = false }
@@ -197,6 +199,7 @@ regex = "1.10"
 reqwest = "0.12"
 rexpect = "0.6"
 revm = "14.0"
+rmcp = "0.2"
 ropey = "1.5"
 rpassword = "7.2"
 rustc-hash = "1.1"

docs/book/spell-check-custom-words.txt

@@ -253,3 +253,14 @@ invariants
 postfix
 impl
 Impl
+mcp
+MCP
+extensibility
+Extensibility
+integrations
+streamable
+Streamable
+schemas
+CallResponse
+md
+URIs

docs/book/src/SUMMARY.md

@@ -109,6 +109,8 @@
     - [forc doc](./forc/plugins/forc_doc.md)
     - [forc fmt](./forc/plugins/forc_fmt.md)
     - [forc lsp](./forc/plugins/forc_lsp.md)
+    - [forc mcp](./forc/plugins/forc_mcp/index.md)
+      - [forc-call tool](./forc/plugins/forc_mcp/forc_call_tool/index.md)
     - [forc migrate](./forc/plugins/forc_migrate.md)
     - [forc node](./forc/plugins/forc_node.md)
     - [forc publish](./forc/plugins/forc_publish.md)