Merge pull request #19 from insightbuilder/notion-mcp-bd

Notion mcp Server to connect with Brain Dump Database

Author: insightbuilder

docs/mcp_notion_brain.md

@@ -0,0 +1,82 @@
+# MCP Server to Brain Dump to Notion
+
+Brain Dumping the ideas and tasks into Notion
+database and later managing them with due dates,
+areas and resources is a classic system. This MCP
+client just needs you to type out your tasks on a
+terminal. The server will then move it to the
+database.
+
+MCP servers have the tools, and resources that can
+be made to work with notion database and its
+properties.
+
+We are implementing the MCP Server to connect with
+Notion database through the notion integration
+API. We are building this so the brain dump
+process can be directly done from any terminal
+that support python.
+
+## Project Details:
+
+- Project Path: ../notion_brain_dump/
+
+### Project setup commands:
+
+```bash
+cd notion_brain_dump
+uv run mcpclient.py server.py
+
+After the client start, you will be prompted for the query.
+
+Query:  Provide me the list of the tasks available.
+```
+
+### Available MCP Server Tools:
+
+- Add Task
+- List Tasks
+- Update Tasks
+- Remove Tasks
+- Add Area
+- Add Resource
+
+These tool are using mcp resources that are
+connecting with the notion db.
+
+When you need use mcp inspector to debug the code,
+use the command below. Ensure you have
+[npx](https://docs.npmjs.com/cli/v8/commands/npx)
+and [node](https://nodejs.org/en/download)
+installed
+
+npx @modelcontextprotocol/inspector uv run
+server.py
+
+### Project Description:
+
+The server.py contains the tools to connect with
+notion database through its API integration. The
+mcpclient.py contains the code to connect with
+LLMs and user.
+
+The functions used in the server.py is taken from
+the ../fw_ex/praw_spiked/vabired_app02.py. The MCP
+server and client are a different interface to the
+way we interact with the computers. So instead of
+using REST API servers, we will use plain english.
+
+### Project References
+
+- Server code referred from :
+  [MCP Installation](https://github.com/modelcontextprotocol/python-sdk?tab=readme-ov-file#installation)
+
+- Client code referred from:
+  [Introducing Clients](https://modelcontextprotocol.io/quickstart/client)
+
+- Notion Code referred from:
+  [Notion Example code](../fw_ex/notionapi_spike/)
+
+```
+
+```

notion_brain_dump/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

notion_brain_dump/.python-version

@@ -0,0 +1 @@
+3.11

notion_brain_dump/README.md

@@ -0,0 +1,154 @@
+import asyncio
+from typing import Optional
+from contextlib import AsyncExitStack
+
+# pyright: reportMissingImports=false
+# pyright: reportOptionalSubscript=false
+
+from mcp import ClientSession, StdioServerParameters
+from mcp.client.stdio import stdio_client
+
+from anthropic import Anthropic
+from dotenv import load_dotenv
+
+# uncomment this when running in your local environment
+# ensure you have updated the .env file with the Anthropic API Key
+# load_dotenv()  # load environment variables from .env
+
+
+class MCPClient:
+    def __init__(self):
+        # Initialize session and client objects
+        self.session: Optional[ClientSession] = None
+        self.exit_stack = AsyncExitStack()
+        self.anthropic = Anthropic()
+
+    # methods will go here
+    async def connect_to_server(self, server_script_path: str):
+        """Connect to notion MCP server
+
+        Args:
+            server_script_path: Path to the server script (.py or .js)
+        """
+        is_python = server_script_path.endswith(".py")
+        is_js = server_script_path.endswith(".js")
+        if not (is_python or is_js):
+            raise ValueError("Server script must be a .py or .js file")
+
+        command = "python" if is_python else "node"
+        server_params = StdioServerParameters(
+            command=command, args=[server_script_path], env=None
+        )
+
+        stdio_transport = await self.exit_stack.enter_async_context(
+            stdio_client(server_params)
+        )
+        self.stdio, self.write = stdio_transport
+        self.session = await self.exit_stack.enter_async_context(
+            ClientSession(self.stdio, self.write)
+        )
+
+        await self.session.initialize()
+
+        # List available tools
+        response = await self.session.list_tools()
+        tools = response.tools
+        print(
+            "\nConnected to Notion MCP server with tools:",
+            [tool.name for tool in tools],
+        )
+
+    async def process_query(self, query: str) -> str:
+        """Process a query using Claude and available tools"""
+        messages = [{"role": "user", "content": query}]
+
+        response = await self.session.list_tools()
+        available_tools = [
+            {
+                "name": tool.name,
+                "description": tool.description,
+                "input_schema": tool.inputSchema,
+            }
+            for tool in response.tools
+        ]
+
+        # Initial Claude API call
+        response = self.anthropic.messages.create(
+            model="claude-3-5-haiku-20241022",
+            max_tokens=1000,
+            messages=messages,
+            tools=available_tools,
+        )
+
+        # Process response and handle tool calls
+        tool_results = []
+        final_text = []
+
+        for content in response.content:
+            if content.type == "text":
+                final_text.append(content.text)
+            elif content.type == "tool_use":
+                tool_name = content.name
+                tool_args = content.input
+
+                # Execute tool call
+                result = await self.session.call_tool(tool_name, tool_args)
+                tool_results.append({"call": tool_name, "result": result})
+                final_text.append(f"[Calling tool {tool_name} with args {tool_args}]")
+
+                # Continue conversation with tool results
+                if hasattr(content, "text") and content.text:
+                    messages.append({"role": "assistant", "content": content.text})
+                messages.append({"role": "user", "content": result.content})
+
+                # Get next response from Claude
+                response = self.anthropic.messages.create(
+                    model="claude-3-5-haiku-20241022",
+                    max_tokens=1000,
+                    messages=messages,
+                )
+
+                final_text.append(response.content[0].text)
+
+        return "\n".join(final_text)
+
+    async def chat_loop(self):
+        """Run an interactive chat loop"""
+        print("\nMCP Client Started!")
+        print("Type your queries or 'quit' to exit.")
+
+        while True:
+            try:
+                query = input("\nQuery: ").strip()
+
+                if query.lower() == "quit":
+                    break
+
+                response = await self.process_query(query)
+                print("\n" + response)
+
+            except Exception as e:
+                print(f"\nError: {str(e)}")
+
+    async def cleanup(self):
+        """Clean up resources"""
+        await self.exit_stack.aclose()
+
+
+async def main():
+    if len(sys.argv) < 2:
+        print("Usage: python mcpclient.py mcpserver.py")
+        sys.exit(1)
+
+    client = MCPClient()
+    try:
+        await client.connect_to_server(sys.argv[1])
+        await client.chat_loop()
+    finally:
+        await client.cleanup()
+
+
+if __name__ == "__main__":
+    import sys
+
+    asyncio.run(main())

notion_brain_dump/mcpclient.py

@@ -0,0 +1,12 @@
+[project]
+name = "notion-brain-dump"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "anthropic>=0.49.0",
+    "mcp[cli]>=1.6.0",
+    "notion-client>=2.3.0",
+    "python-dotenv>=1.1.0",
+]